ONLINE RUNBOOK
Immich update procedure
A Docker Compose maintenance procedure.
Use your deployment’s Compose directory and service names in the commands below.
Confirm readiness
Review release notes, confirm a recent backup, verify storage availability, and identify the correct Compose project.
Connect through the private administrative path
Use the management network or VPN. Confirm the target host and Compose directory before changing anything.
cd <immich-compose-directory> pwd docker compose psPull the approved images
Download the images referenced by the existing Compose configuration.
docker compose pullRedeploy the stack
Recreate changed containers in detached mode, preserving configured persistent storage.
docker compose up -dValidate service health
Check service state and inspect recent logs for startup, database, permission or storage errors.
docker compose ps docker compose logs --tail=100 <service-name>Test the application
Sign in through the normal user-facing URL. Confirm library visibility, upload behavior and background processing.
Validation checklist
| Check | Expected result |
|---|---|
| Containers | Expected services are running or healthy |
| Web interface | Authentication and navigation work |
| Storage | Libraries and uploads are accessible |
| Logs | No persistent database, cache or application errors |
Safety notes
- Update each independent environment separately.
- Do not remove persistent volumes during routine maintenance.
- Stop and investigate missing storage mounts or unavailable database services.
- Keep backup and rollback information available before maintenance.