immich/docs/docs/install/portainer.md

sidebar_position
50

Portainer

Install Immich using Portainer's Stack feature.

1. Go to "Stacks" in the left sidebar.
2. Click on "Add stack".
3. Give the stack a name (i.e. immich), and select "Web Editor" as the build method.
4. Copy the content of the docker-compose.yml file from the GitHub repository.
5. Replace .env with stack.env for all containers that need to use environment variables in the web editor.

<img src={require('./img/dot-env.webp').default} width="50%" style={{border: '1px solid #ddd'}} alt="Dot Env Example" />

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

<img src={require('./img/env-1.webp').default} width="50%" style={{border: '1px solid #ddd'}} alt="Dot Env Example" />

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

<img src={require('./img/env-2.webp').default} width="50%" style={{border: '1px solid #ddd'}} alt="Dot Env Example" />

• Change the default DB_PASSWORD, and add custom database connection information if necessary.
• Change DB_DATA_LOCATION to a folder (absolute path) where the database will be saved to disk.
• Change UPLOAD_LOCATION to a folder (absolute path) where media (uploaded and generated) will be stored.

11. Click on "Deploy the stack".

:::tip For more information on how to use the application, please refer to the Post Installation guide. :::