Skip to main content


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.
Dot Env Example
  1. Click on "Advanced Mode" in the Environment Variables section.
Dot Env Example
  1. Copy the content of the .env.example file from the GitHub repository and paste into the editor.
  2. Switch back to "Simple Mode".
Dot Env Example
  • Populate custom database information if necessary.
  • Populate UPLOAD_LOCATION with your preferred location for storing backup assets.
  • Populate a secret value for JWT_SECRET. You can use the command below to generate a secure key:
Generate secure JWT_SECRET key
openssl rand -base64 128
  1. Click on "Deploy the stack".

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