Immich Server

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. |
Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions, including the security model for host vs. container privileges.
Deployment
Interactive Configuration
Parameters
Environment Variables
| 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. |
Volumes
| 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) |
Ports
| Port |
Protocol |
Description |
2283 |
TCP |
Web UI/API |
This image is part of the Immich Stack.
Implementation Details
- Architectures: amd64
- User:
bsd (UID/GID set via PUID/PGID). Defaults to 1000:1000.
- Base: Built on
ghcr.io/daemonless/base (FreeBSD 15.1).
Need help? Join our Discord community.