heyer.systems Open Source

Immich

Self-hosted photo and video library with automatic backup from phones, face recognition and smart search.

Install

On the Proxmox node as root:

bash -c "$(curl -fsSL https://iac.heyer.systems/immich/ct.sh)"

Container from the Debian 13 template · default: 4 CPU, 6144 MiB RAM, 32 GiB disk

Customise the commandYour own values for CPU, RAM, network and modules – no dialog

Then: Web: http://<IP>:2283/ – login: [email protected], password in the guest: grep immich_admin_password /etc/iac/settings.env

Settings per instance

SettingMeaning
immich_media_locationMedia location – Directory for photos, videos and thumbnails, e.g. the mount point of a separate disk (default: /var/lib/immich/library).

When creating a container, as var_<setting>:

var_immich_media_location="<value>" bash -c "$(curl -fsSL https://iac.heyer.systems/immich/ct.sh)"

Set or change later, in the guest (for VMs the only way so far): a line immich_media_location=<value> in /etc/iac/settings.env – no quotes, the last line of a setting wins – then:

update

Missing or empty = the app's default. Do not edit the configuration files iac writes – update overwrites them; their first lines name the file for local changes.

Update

In the guest:

update

Debian packages, Immich, modules and the iac configuration. Major versions never change automatically.

Add modules – any time, in containers and VMs alike:

update --list-modules
update --add-modules node-exporter

All modules · More about update

Adopt an existing installation in the guest as root

bash -c "$(curl -fsSL https://iac.heyer.systems/immich/adopt.sh)"

Checks first and stops before any change if an automatic adoption is not possible – then follow the migration guide.