Updating

git pull

Check the release notes before updating — some versions require manual steps.

Local Development

docker compose up -d --build

If dependencies changed:

docker compose exec app composer install
docker compose exec frontend npm install

Production

Code and frontend are built into the prod image during docker compose build. After git pull, rebuild and restart:

git pull
docker compose -f docker-compose.prod.yml build
docker compose -f docker-compose.prod.yml up -d
docker compose -f docker-compose.prod.yml exec app php artisan migrate --force
docker compose -f docker-compose.prod.yml exec app php artisan config:cache
docker compose -f docker-compose.prod.yml exec app php artisan route:cache
docker compose -f docker-compose.prod.yml exec app php artisan view:cache
docker compose -f docker-compose.prod.yml exec app php artisan horizon:terminate

If new variables were added to .env.example — add them to .env and restart.

Issues After Updating

Dev:

docker compose logs app
docker compose exec app php artisan migrate:status
docker compose exec app php artisan optimize:clear

Production:

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