Overview
If you want a fast and reliable way to self-host Immich without digging through long documentation, this guide keeps things simple. We’ll use Portainer to deploy the stack and Cloudflare Tunnel to make Immich securely accessible from anywhere.
Let’s jump right in. 🚀
Preparation
This guide assumes you have completed the following prerequisites:
A Cloudflare account with the Zero-Trust portal set up.
Access to a server: via WebUI for devices like NAS (Synology, QNAP, UGREEN) or via SSH for headless servers without a web interface.
No Prerequisites Yet? Start with These Step-by-Step Guides
Installation
Choose installation method below.
Let's starting with downloading necessary docker files. We need to two files, docker compose and environments file.
Click below buttons to download them:
Once that's done, fire up your Portainer and let's get Immich up and running:
- Open Portainer
- Go to Stacks
- Click Add stacks button at the top right corner
- Name the stack: We recommend naming it simple and intuitive like immich
- In Build method, choose Upload
- Let's upload the compose first. For that click on Select file, then choose the docker-compose-portainer.yml you have downloaded above.
Now let's upload environment file as well. Scroll down to Environment variables section.
- Click Load variables from .env file
- Choose the .env file you downloaded in previous step
- If you did everything correctly, you should see environments load like on the screenshot.
