46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# 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
|
|
```
|
|
|
|
## Last.fm errors
|
|
- Verify credentials in `/admin/settings` or env var `LASTFM_API_KEY`.
|
|
|
|
## ARM64 Build
|
|
|
|
```bash
|
|
sudo docker buildx build \
|
|
--platform linux/arm64 \
|
|
--target prod \
|
|
-t tonehaus/tonehaus:dev-arm64 \
|
|
-f docker/php/Dockerfile \
|
|
. \
|
|
--load
|
|
```
|