Install and upgrade
Pick an installation method below, then keep the instance up to date with Upgrading. If you just want to try Immich, Quick start walks through the shortest path to a working instance.
Check the requirements before you begin.
Official methods
Maintained by the Immich team. Report problems on the Immich repository.
| Method | Notes |
|---|---|
| Docker Compose | Recommended. The method every other official method is built on. |
| Portainer | Deploys the official Compose file through Portainer's Stack editor. |
| Kubernetes | Uses the official Helm chart. |
| Install script | Experimental, Linux only. Not recommended for production. |
Community methods
Contributed and maintained outside the Immich team, and included here for convenience. They are not officially supported — support and issue reports go to the project or platform listed, not to the Immich repository.
| Method | Support |
|---|---|
| Unraid | Dedicated channel on the Discord server |
| TrueNAS | truenas/apps repository, plus Discord |
| Synology | Synology-specific support platforms |
| All-in-One | imagegenius/docker-immich repository |
| One-click cloud marketplaces | The cloud provider hosting the marketplace image |