tonehaus/docs/07-troubleshooting.md

Troubleshooting

Cannot find template or routes

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

Missing vendors

• Install: docker compose exec php 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 06-admin-and-settings.md to grant roles.