Troubleshooting

Another process is using the same port. Change the port in .env (e.g. FRONTEND_PORT=3001) then restart:

docker compose up -d

The app key wasn't generated. Run:

docker compose exec backend php artisan key:generate
docker compose exec backend php artisan optimize:clear

PostgreSQL may still be starting — wait a few seconds and retry. Check the logs and verify credentials match between root .env and backend/.env:

docker compose logs postgres

Clear the Next.js cache and restart:

docker compose exec frontend rm -rf .next
docker compose restart frontend

You need the Stripe CLI running in a separate terminal:

stripe listen --forward-to localhost:8000/api/stripe/webhook

Copy the whsec_xxx output into STRIPE_WEBHOOK_SECRET in backend/.env.

The redirect URI in Google Cloud Console must match exactly. No trailing slash, correct protocol:

• Local: http://localhost:8000/api/auth/google/callback
• Prod: https://api.yourdomain.com/api/auth/google/callback

localhost and 127.0.0.1 are treated as different origins by Google.

Make sure backend/.env uses the Docker service name, not localhost:

MAIL_HOST=mailpit
MAIL_PORT=1025

First, check what changed and find the error:

git diff
cd frontend && npx tsc --noEmit
docker compose exec backend php artisan test

If the error is deep, git stash your changes and re-run npx stacktura init from a clean state.