# ![Immich Server](<https://daemonless.io/images/logos/immich-server.svg>) Immich Server

[![Build Status](<https://img.shields.io/github/actions/workflow/status/daemonless/immich-server/build.yaml?style=flat-square&amp;label=Build&amp;color=green>)](<https://github.com/daemonless/immich-server/actions>) [![Last Commit](<https://img.shields.io/github/last-commit/daemonless/immich-server?style=flat-square&amp;label=Last+Commit&amp;color=blue>)](<https://github.com/daemonless/immich-server/commits>) [![OCI Pulls](<https://img.shields.io/docker/pulls/daemonless/immich-server?style=flat-square&amp;label=OCI+Pulls&amp;color=blue>)](<https://hub.docker.com/r/daemonless/immich-server>)

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`](<https://github.com/daemonless/immich-server/pkgs/container/immich-server>) |
| **Daemonless** | [daemonless/immich-server](<https://github.com/daemonless/immich-server>) |
| **Source** | [immich-app/immich](<https://github.com/immich-app/immich>) |
| **Website** | [immich.app](<https://immich.app/>) |

This image is part of the [Immich Stack](<https://daemonless.io/images/immich>).

## 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. |

> [!NOTE]
>
> **Implementation Details**
>
> - **Architectures:** amd64, aarch64
> - **User:** `bsd` (UID/GID set via [PUID/PGID](<https://daemonless.io/guides/permissions/index.md>)). Defaults to `1000:1000`.
> - **Base:** Built on `ghcr.io/daemonless/base` (FreeBSD 15.1).

---

Need help? Join our [Discord](<https://discord.gg/Kb9tkhecZT>) community.
