Skip to content


What is it?

Immich is a self-hosted photo and video backup tool, similar to google photos and apple photos.


  • Bulk Upload (Using the CLI)
  • Facial Recognition
  • Hardware Transcoding (Experimental)
  • Oauth and/or password login
  • Libraries
  • Mobile App
  • Partner Sharing
  • Reverse Geocoding
  • Smart Search
  • XMP Sidecars


By default, Immich is NOT protected behind your Authelia/SSO middleware. You have to create a user with an email and password for Immich upon start up. Its recommended that you use the email and password you set up upon instalation for consistencies sake.

Project home Docs Github

1. Installation

sb install sandbox-immich

2. URL

  • To access Immich, visit https://immich._yourdomain.com_

3. Setup


📢 Again, no default user is configured until you run through the setup screen, so you would ideally run through setup as soon as immich is deployed to secure the site. It is not behind authelia by default.


In Administration > Settings is a button to copy the current admin configuration to your clipboard. So you can just grab it from there, and paste it into a file.

If you would like to have the config file available, create a new config file (e.g. immich.config, and the config format is .json) and map it in inventory; just keep in mind that this disallows you from configuring Immich admin settings from the web ui.

  IMMICH_CONFIG_FILE: "/config/immich.config"