immich-server

概述

Immich is a high-performance, self-hosted photo and video management solution. This is the main "immich-server" service (it runs both the API and microservices workers) from the official Immich `docker-compose.yml` and provides the web UI on port 2283. This container depends on the "immich-postgres", "immich-redis" and "immich-machine-learning" containers. All four containers MUST share the same user-defined Docker network (named "immich" in these templates) so that Immich can reach them by container name. Start order: immich-postgres and immich-redis first, then immich-machine-learning, then immich-server. The DB_PASSWORD set here MUST match POSTGRES_PASSWORD in the `immich-postgres` container.

要求

Requires the immich-postgres, immich-redis and immich-machine-learning containers to be running on the same custom Docker network ("immich", create it by running `docker network create immich`).

运行时参数

网络用户界面: http://[IP]:[PORT:2283]/
网络: immich

模板配置

WebUI PortPorttcp

Port for the Immich web interface and mobile app API.

目标: 2283
默认值: 2283
价值: 2283

Upload / media locationPathrw

Where Immich stores uploaded photos and videos (thumbnails, originals, etc). Equivalent to UPLOAD_LOCATION in the compose .env file. Point this at an array share with enough space, e.g. /mnt/user/photos/immich.

目标: /data
默认值: /mnt/user/photos/immich
价值: /mnt/user/photos/immich

Database hostVariable

Hostname of the Postgres container. Must equal the Name of the postgres container (immich-postgres) and both must be on the 'immich' network.

目标: DB_HOSTNAME
默认值: immich-postgres
价值: immich-postgres

Database portVariable

Postgres port (internal). Leave at 5432.

目标: DB_PORT
默认值: 5432
价值: 5432

Database userVariable

Postgres username. Must match POSTGRES_USER in immich-postgres.

目标: DB_USERNAME
默认值: postgres
价值: postgres

Database passwordVariable

Postgres password. MUST match POSTGRES_PASSWORD in the immich-postgres container. Use only A-Za-z0-9 characters.

目标: DB_PASSWORD

Database nameVariable

Postgres database name. Must match POSTGRES_DB in immich-postgres.

目标: DB_DATABASE_NAME
默认值: immich
价值: immich

Redis hostVariable

Hostname of the Redis/Valkey container. Must equal the Name of the redis container (immich-redis) and both must be on the 'immich' network.

目标: REDIS_HOSTNAME
默认值: immich-redis
价值: immich-redis

Redis portVariable

Redis port (internal). Leave at 6379.

目标: REDIS_PORT
默认值: 6379
价值: 6379

Machine learning URLVariable

URL of the machine-learning container. Must use the Name of the ML container (immich-machine-learning) on the 'immich' network. Set to 'false' to disable ML entirely.

目标: IMMICH_MACHINE_LEARNING_URL
默认值: http://immich-machine-learning:3003
价值: http://immich-machine-learning:3003

TimezoneVariable

Optional timezone, e.g. Europe/Amsterdam or Etc/UTC. Affects timestamps shown in the UI.