Installing Photoprism with Docker for Photo Management#

Docker#

Enable running Docker without sudo. Replace “username” with your own:

sudo usermod -aG docker username

Download Photoprism:

mkdir photoprism
cd photoprism
wget https://dl.photoprism.app/docker/compose.yaml -O docker-compose.yml

Open docker-compose.yml:

nano docker-compose.yml

Set ports and environment variables as follows:

services:
  photoprism:
    ports:
      - "6342:2342"
    environment:
      PHOTOPRISM_ADMIN_USER: "your username"
      PHOTOPRISM_ADMIN_PASSWORD: "your password"
      PHOTOPRISM_BACKUP_DATABASE: "false"
      PHOTOPRISM_SITE_URL: "https://photos.example.com"
      PHOTOPRISM_DEFAULT_TLS: "false"
      PHOTOPRISM_DISABLE_TENSORFLOW: "true"
      PHOTOPRISM_DISABLE_FACES: "true"
      PHOTOPRISM_DISABLE_CLASSIFICATION: "true"
      PHOTOPRISM_BACKUP_DATABASE: "false"
      PHOTOPRISM_DATABASE_PASSWORD: "database password"
      PHOTOPRISM_SITE_CAPTION: "Photoprism"
      PHOTOPRISM_SITE_AUTHOR: "your name"

Update database password:

  mariadb:
    environment:
      MARIADB_PASSWORD: "same as PHOTOPRISM_DATABASE_PASSWORD above"
      MARIADB_ROOT_PASSWORD: "same as PHOTOPRISM_DATABASE_PASSWORD above"

Comment out the entire watchtower section:

# watchtower:
#   restart: unless-stopped

Start Photoprism:

docker compose up -d

Reverse Proxy#

Install Caddy:

sudo apt install caddy

Open Caddyfile:

sudo nano /etc/caddy/Caddyfile

Update Caddyfile:

example.com {
  route /photos* {
    uri strip_prefix /photos
    redir https://photos.{host}{uri}
  }
}

photos.example.com {
  reverse_proxy localhost:6342
  rewrite / /s/gallery/album
}

Restart Caddy:

sudo systemctl restart caddy

Go to Photoprism at https://photos.example.com or at https://example.com/photos if you prefer using a subpath. Login using the PHOTOPRISM_ADMIN_USER and PHOTOPRISM_ADMIN_PASSWORD you set in the docker-compose.yml above.

Create a new album and share it using secret key “gallery”. Anyone with your Photoprism link can view your album.