Решение проблем

Контейнер app не запускается

docker compose ps
docker compose logs db
docker compose logs app

Проверьте .env: DB_HOST=db, REDIS_HOST=redis, DB_DATABASE, DB_USERNAME, DB_PASSWORD.

Ошибка APP_KEY

docker compose exec app php artisan key:generate

Миграции не применились

Dev:

docker compose exec app rm -f storage/.dev-initialized
docker compose restart app

Или вручную:

docker compose exec app php artisan migrate --force

Production:

docker compose -f docker-compose.prod.yml exec app php artisan migrate --force

Horizon или Reverb не работают

docker compose exec app supervisorctl status
docker compose exec app supervisorctl tail -f horizon
docker compose exec app supervisorctl tail -f reverb

Убедитесь, что порт 9001 открыт и переменные REVERB_* / VITE_REVERB_* заданы в .env.

Frontend не обновляется

docker compose restart frontend

Проверьте VITE_DEV_SERVER_URL в docker-compose.yml.

Почта не отправляется

Проверьте настройки в Админ-панели → Почта. См. Почта.

Ошибки прав на storage/

docker compose exec app chown -R www-data:www-data storage bootstrap/cache
docker compose exec app chmod -R 775 storage bootstrap/cache

/horizon или /log-viewer возвращает 403

Добавьте email в Админ-панель → Система → Доступы (/admin-panel/system/access) — поля horizonAdmins и logViewerAdmins. Настройки хранятся в БД, переменная HORIZON_ADMINS в .env не используется.

Белый экран или 500 в production

docker compose -f docker-compose.prod.yml logs app
docker compose -f docker-compose.prod.yml exec app php artisan optimize:clear

Медиафайлы не загружаются

docker compose exec app php artisan storage:link

Проверьте лимиты в Админ-панели → Медиа (/admin-panel/settings/media). Значения MEDIA_MAX_SIZE и MEDIA_ALLOWED_MIMES в .env используются только как резервные.

Логи

Источник	Путь / команда
Laravel	storage/logs/laravel.log
Контейнеры	docker compose logs app
Horizon	http://journalphp.test/horizon → Failed Jobs
Log Viewer	http://journalphp.test/log-viewer
Supervisor	docker compose exec app supervisorctl tail -f <program>

Проблема не решена

Создать issue → — приложите лог, версию (git log --oneline -1) и окружение.