Skip to content

Immich Server Immich Server

Build Status Last Commit OCI Pulls

Self-hosted photo and video backup and management server with web UI, mobile sync, and shared albums.

Port 2283
Registry ghcr.io/daemonless/immich-server
Daemonless daemonless/immich-server
Source immich-app/immich
Website immich.app

This image is part of the Immich Stack.

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

Version Tags

Multi-arch manifests — resolve automatically to the right image for your platform.

Tag Description Best For
latest Upstream Binary. Built from official release. Most users — recommended.
Tag Description Best For
latest-amd64 Upstream Binary. Built from official release. Most users — recommended.
Tag Description Best For
latest-aarch64 Upstream Binary. Built from official release. Most users — recommended.

Implementation Details

  • Architectures: amd64, aarch64
  • 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.