Levelrail
Skip to content

Self-host Immich with Docker ​

Self-hosted photo and video backup with mobile apps, facial recognition, and timeline search.

This page describes the Levelrail template for Immich (Media). It deploys the services below as one Docker Compose app on your own server.

Project site: https://immich.app/docs.

Recommended memory: about 1536 MiB.

Services, ports and volumes ​

ServiceImageContainer portsVolumes
dbghcr.io/immich-app/postgres:14-vectorchord0.3.0-pgvectors0.2.0none
immich_db_data -> /var/lib/postgresql/data
immich-machine-learningghcr.io/immich-app/immich-machine-learning:v1.126.1none
immich_ml_cache -> /cache
immich-serverghcr.io/immich-app/immich-server:v1.126.12283
immich_upload_data -> /usr/src/app/upload
redisredis:7.4-alpinenonenone

Environment variables ​

ServiceVariableValue
dbPOSTGRES_DBPreset in the template
dbPOSTGRES_PASSWORDGenerated at deploy
dbPOSTGRES_USERPreset in the template
immich-serverDB_DATABASE_NAMEPreset in the template
immich-serverDB_HOSTNAMEPreset in the template
immich-serverDB_PASSWORDGenerated at deploy
immich-serverDB_USERNAMEPreset in the template
immich-serverREDIS_HOSTNAMEPreset in the template

Passwords and keys marked as generated are created for you when the app is deployed and stored as secrets. Values are not shown here.

Deploy Immich with Levelrail ​

In the dashboard, open Apps, choose New app, then Browse templates, and select Immich. Review the Compose body and deploy.

With the CLI:

levelrail-cli templates deploy immich --name my-immich

See Service template catalog for how templates work, and Getting started if you have not installed Levelrail yet.

More Media templates ​

All templates are listed in the self-host gallery.

Released under the Apache 2.0 License.