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 (for example 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.

Environment variables advanced

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

Environment variables simple

  • 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.
  1. Click on Deploy the stack.

TIP

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