
Self-hosted photo and video backup and management server with web UI, mobile sync, and shared albums.
| Tag |
Description |
Best For |
latest |
Upstream Binary. Built from official release. |
Most users — recommended. |
beta |
Upstream Binary. Built from official release. |
Alternative build. |
| Variable |
Default |
Description |
DB_HOSTNAME |
immich-postgres |
Postgres database hostname |
DB_USERNAME |
postgres |
Postgres database user |
DB_PASSWORD |
postgres |
Postgres database password |
DB_DATABASE_NAME |
immich |
Postgres database name |
REDIS_HOSTNAME |
immich-redis |
Redis hostname |
PUID |
1000 |
User ID for the application process |
PGID |
1000 |
Group ID for the application process |
TZ |
UTC |
Timezone for the container |
SKIP_CHOWN |
true |
Skip the startup recursive chown of /config and /data once ownership is recorded in /config/.chown_done (default true). Set false to force a chown on every start. The marker lives in /config, so /config must be a persistent volume for the skip to take effect across restarts. |
| Path |
Description |
/config |
Holds the startup ownership marker (.chown_done). Mount as a persistent volume so the chown is skipped on later starts. |
/data |
Media storage (photos, videos, thumbnails) |
| Port |
Protocol |
Description |
2283 |
TCP |
Web UI/API |
This image is part of the Immich Stack.
Architectures: amd64, aarch64
User: bsd (UID/GID via PUID/PGID, defaults to 1000:1000)
Base: FreeBSD 15.1
Need help? Join our Discord community.