Portainer
Install Immich using Portainer's Stack feature.
- Go to "Stacks" in the left sidebar.
- Click on "Add stack".
- Give the stack a name (i.e. Immich), and select "Web Editor" as the build method.
- Copy the content of the
docker-compose.yml
file from the GitHub repository. - Replace
.env
withstack.env
for all containers that need to use environment variables in the web editor.

- Click on "Advanced Mode" in the Environment Variables section.

- Copy the content of the
example.env
file from the GitHub repository and paste into the editor. - Switch back to "Simple Mode".

- Populate custom database information if necessary.
- Populate
UPLOAD_LOCATION
with your preferred location for storing backup assets.
- Click on "Deploy the stack".
tip
For more information on how to use the application, please refer to the Post Installation guide.