Platforms

Immich on Proxmox: Choose the Supported Boundary

What Immich documents for Proxmox, Docker in LXC, full VMs, storage, and migration decisions.

Direct answer

Immich runs well in a full virtual machine. The current requirements say Docker inside an LXC container is not recommended and advise switching to a supported VM when troubleshooting becomes difficult. Docker Compose remains the recommended production method.

Use a supported 64-bit Linux guest, Docker Engine with the Compose plugin, local storage for Postgres, and at least 6 GB RAM. For v3 on amd64, the machine-learning container requires x86-64-v2.

What the community record says

In Discussion #29317, a user asked whether to migrate a working Docker-in-LXC install to the Proxmox community Immich LXC. A maintainer replied that Docker is still the only recommended and supported method. The discussion does not provide a migration recipe.

Discussion #29626 describes a v2.7.5 → v3.0.1 restart loop in Docker on Proxmox. A responder suspected memory pressure during initial geodata work; the author reported temporarily adding RAM helped. This remains environment-specific.

Before migrating

Back up the database and media, record the current container paths, and test a restore. Do not start a migration solely because a working LXC setup feels untidy; the source record contains no official dedicated-LXC migration procedure.

Sources