tonehaus/docs/troubleshooting.md

Troubleshooting

Cannot find template or routes

• Clear cache: docker compose exec tonehaus php bin/console cache:clear
• List routes: docker compose exec tonehaus php bin/console debug:router

Missing vendors

• Install: docker compose exec tonehaus composer install --no-interaction --prefer-dist

.env not read in container

• Ensure we mount .env or set env vars in compose; we mount .env in docker-compose.yml.

Login modal shows blank

• Make sure Bootstrap JS loads before the modal script (handled in base.html.twig).

Hitting admin routes redirects to home

• Expected when not logged in or lacking the required role.
• Ensure your user has ROLE_MODERATOR for /admin/dashboard or /admin/users, and ROLE_ADMIN for /admin/settings.
• Use the console commands in admin-and-settings.md to grant roles.

SQLite file permissions

• The default SQLite path is var/data/database.sqlite.
• If migrations fail at startup: ensure the sqlite_data volume is attached and the path is writable by the container user.

Postgres connection issues

• If you enable the db service in docker-compose.yml, verify DATABASE_URL matches the service name and credentials.
• Example URL:

  postgresql://symfony:symfony@db:5432/symfony?serverVersion=16&charset=utf8
  

Spotify errors

• Verify credentials in /admin/settings or env vars SPOTIFY_CLIENT_ID / SPOTIFY_CLIENT_SECRET.
• Client Credentials tokens are cached; if revoked, wait for expiry or restart the container.

ARM64 Build

sudo docker buildx build \                                            
    --platform linux/arm64 \
    --target prod \
    -t tonehaus/tonehaus:dev-arm64 \
    -f docker/php/Dockerfile \
    . \
    --load