Config: Add PHOTOPRISM_SITE_NAME to compose examples and Helm charts

Also align the SITE_* inline doc comments with the CLI flag help.
2026-07-17 16:49:04 +00:00 · 2026-06-10 14:28:50 +00:00 · 2026-06-10 14:28:50 +00:00 · a7ee3c2e19
commit a7ee3c2e19
parent 785ae60a9d
17 changed files with 71 additions and 50 deletions
--- a/compose.intel.yaml
+++ b/compose.intel.yaml
@ -87,9 +87,10 @@ services:
      PHOTOPRISM_DEFAULT_TLS: "true"
      ## Site Information:
      PHOTOPRISM_SITE_URL: "https://app.localssl.dev/"    # server URL in the format "http(s)://domain.name(:port)/(path)"
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!"
-      PHOTOPRISM_SITE_AUTHOR: "@photoprism_app"
+      PHOTOPRISM_SITE_NAME: ""                            # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"    # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!"  # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: "@photoprism_app"           # site owner shown in the author meta tag
      PHOTOPRISM_DEBUG: "true"
      PHOTOPRISM_READONLY: "false"
      PHOTOPRISM_EXPERIMENTAL: "true"
--- a/compose.latest.yaml
+++ b/compose.latest.yaml
@ -27,9 +27,10 @@ services:
      PHOTOPRISM_ADMIN_PASSWORD: "photoprism"              # initial admin password (8-72 characters)
      PHOTOPRISM_AUTH_MODE: "password"                     # authentication mode (public, password)
      PHOTOPRISM_SITE_URL: "https://latest.localssl.dev/"  # server URL in the format "http(s)://domain.name(:port)/(path)"
-      PHOTOPRISM_SITE_CAPTION: "Latest"
-      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!"
-      PHOTOPRISM_SITE_AUTHOR: "@photoprism_app"
+      PHOTOPRISM_SITE_NAME: ""                             # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_CAPTION: "Latest"                    # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!"  # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: "@photoprism_app"            # site owner shown in the author meta tag
      PHOTOPRISM_DEBUG: "true"
      PHOTOPRISM_READONLY: "false"
      PHOTOPRISM_EXPERIMENTAL: "false"
--- a/compose.nvidia.yaml
+++ b/compose.nvidia.yaml
@ -90,9 +90,10 @@ services:
      PHOTOPRISM_DEFAULT_TLS: "true"
      ## Site Information:
      PHOTOPRISM_SITE_URL: "https://app.localssl.dev/"    # server URL in the format "http(s)://domain.name(:port)/(path)"
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!"
-      PHOTOPRISM_SITE_AUTHOR: "@photoprism_app"
+      PHOTOPRISM_SITE_NAME: ""                            # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"    # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!"  # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: "@photoprism_app"           # site owner shown in the author meta tag
      PHOTOPRISM_DEBUG: "true"
      PHOTOPRISM_READONLY: "false"
      PHOTOPRISM_EXPERIMENTAL: "true"
--- a/compose.preview.yaml
+++ b/compose.preview.yaml
@ -27,9 +27,10 @@ services:
      PHOTOPRISM_ADMIN_PASSWORD: "photoprism"              # initial admin password (8-72 characters)
      PHOTOPRISM_AUTH_MODE: "password"                     # authentication mode (public, password)
      PHOTOPRISM_SITE_URL: "https://preview.localssl.dev/" # server URL in the format "http(s)://domain.name(:port)/(path)"
-      PHOTOPRISM_SITE_CAPTION: "Preview"
-      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!"
-      PHOTOPRISM_SITE_AUTHOR: "@photoprism_app"
+      PHOTOPRISM_SITE_NAME: ""                             # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_CAPTION: "Preview"                   # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!"  # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: "@photoprism_app"            # site owner shown in the author meta tag
      PHOTOPRISM_DEBUG: "true"
      PHOTOPRISM_READONLY: "false"
      PHOTOPRISM_EXPERIMENTAL: "false"
--- a/compose.yaml
+++ b/compose.yaml
@ -94,9 +94,10 @@ services:
      PHOTOPRISM_DEFAULT_TLS: "true"
      ## Site Information:
      PHOTOPRISM_SITE_URL: "${PHOTOPRISM_SITE_URL:-https://app.localssl.dev/}" # "http(s)://domain.name(:port)/(path)"
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!"
-      PHOTOPRISM_SITE_AUTHOR: "@photoprism_app"
+      PHOTOPRISM_SITE_NAME: "" # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App" # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!" # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: "@photoprism_app" # site owner shown in the author meta tag
      PHOTOPRISM_DEBUG: "true"
      PHOTOPRISM_READONLY: "false"
      PHOTOPRISM_EXPERIMENTAL: "true"
--- a/docker/demo/compose.yaml
+++ b/docker/demo/compose.yaml
@ -17,11 +17,12 @@ services:
      PHOTOPRISM_PUBLIC: "true"
      PHOTOPRISM_SITE_URL: "https://demo.yourdomain.com/"
      # PHOTOPRISM_CDN_URL: "https://demo-cdn.yourdomain.com/"
-      PHOTOPRISM_SITE_TITLE: "PhotoPrism"
-      PHOTOPRISM_SITE_CAPTION: "Demo"
-      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!"
-      PHOTOPRISM_SITE_PREVIEW: "https://i.photoprism.app/logo?cover=17&title=Demo"
-      PHOTOPRISM_SITE_AUTHOR: "PhotoPrism"
+      PHOTOPRISM_SITE_NAME: ""  # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_TITLE: "PhotoPrism"  # main title shown in the web interface and meta tags
+      PHOTOPRISM_SITE_CAPTION: "Demo"  # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: "Tags and finds pictures without getting in your way!"  # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_PREVIEW: "https://i.photoprism.app/logo?cover=17&title=Demo"  # sharing preview image URL
+      PHOTOPRISM_SITE_AUTHOR: "PhotoPrism"  # site owner shown in the author meta tag
      PHOTOPRISM_HTTP_COMPRESSION: "zstd,gzip"
      PHOTOPRISM_DEFAULT_LOCALE: "en"

--- a/setup/charts/plus/questions.yaml
+++ b/setup/charts/plus/questions.yaml
@ -4,6 +4,11 @@ questions:
    label: "Image Tag"
    description: "Override the container tag; leave empty to use the chart appVersion."
    type: string
+  - variable: config.PHOTOPRISM_SITE_NAME
+    group: "Customization"
+    label: "Site Name"
+    description: "Optional short name identifying this instance in cluster switchers and selectors. Example: Acme Media."
+    type: string
  - variable: config.PHOTOPRISM_SITE_TITLE
    group: "Customization"
    label: "Site Title"
--- a/setup/charts/plus/values.yaml
+++ b/setup/charts/plus/values.yaml
@ -103,6 +103,7 @@ oidc:

 config:
  PHOTOPRISM_SITE_URL: ""
+  PHOTOPRISM_SITE_NAME: ""
  PHOTOPRISM_SITE_TITLE: "PhotoPrism"
  PHOTOPRISM_SITE_CAPTION: ""
  PHOTOPRISM_SITE_DESCRIPTION: ""
--- a/setup/cloud/digitalocean/compose.yaml
+++ b/setup/cloud/digitalocean/compose.yaml
@ -123,9 +123,10 @@ services:
    environment:
      ## !! CHANGE site url if your server has a public domain name e.g. "https://photos.yourdomain.com/" !!
      PHOTOPRISM_SITE_URL: "https://_public_ip_/"
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: ""                  # meta site description
-      PHOTOPRISM_SITE_AUTHOR: ""                       # meta site author
+      PHOTOPRISM_SITE_NAME: ""                         # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"  # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: ""                  # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: ""                       # site owner shown in the author meta tag
      PHOTOPRISM_ADMIN_PASSWORD: "_admin_password_"    # YOUR INITIAL "admin" PASSWORD
      PHOTOPRISM_AUTH_MODE: "password"                 # authentication mode (public, password)
      PHOTOPRISM_HTTP_COMPRESSION: "zstd,gzip"         # improves transfer speed and bandwidth utilization (none, gzip, zstd, or comma-separated list e.g. "zstd,gzip")
--- a/setup/docker/arm64/compose.yaml
+++ b/setup/docker/arm64/compose.yaml
@ -62,10 +62,11 @@ services:
      PHOTOPRISM_DEFAULT_LOCALE: "en"                # default user interface language, e.g. "en" or "de"
      PHOTOPRISM_PLACES_LOCALE: "local"              # location details language, e.g. "local", "en", or "de"
      PHOTOPRISM_SITE_URL: "http://localhost:2342/"  # server URL in the format "http(s)://domain.name(:port)/(path)"
-      PHOTOPRISM_SITE_TITLE: "PhotoPrism"
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: ""                # meta site description
-      PHOTOPRISM_SITE_AUTHOR: ""                     # meta site author
+      PHOTOPRISM_SITE_NAME: ""                       # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_TITLE: "PhotoPrism"            # main title shown in the web interface and meta tags
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"  # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: ""                # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: ""                     # site owner shown in the author meta tag
      PHOTOPRISM_LOG_LEVEL: "info"                   # log level: trace, debug, info, warning, or error
      PHOTOPRISM_READONLY: "false"                   # do not modify originals directory (reduced functionality)
      PHOTOPRISM_EXPERIMENTAL: "false"               # enables experimental features
--- a/setup/docker/compose.yaml
+++ b/setup/docker/compose.yaml
@ -53,10 +53,11 @@ services:
      PHOTOPRISM_DEFAULT_LOCALE: "en"                # default user interface language, e.g. "en" or "de"
      PHOTOPRISM_PLACES_LOCALE: "local"              # location details language, e.g. "local", "en", or "de"
      PHOTOPRISM_SITE_URL: "http://localhost:2342/"  # server URL in the format "http(s)://domain.name(:port)/(path)"
-      PHOTOPRISM_SITE_TITLE: "PhotoPrism"
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: ""                # meta site description
-      PHOTOPRISM_SITE_AUTHOR: ""                     # meta site author
+      PHOTOPRISM_SITE_NAME: ""                       # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_TITLE: "PhotoPrism"            # main title shown in the web interface and meta tags
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"  # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: ""                # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: ""                     # site owner shown in the author meta tag
      PHOTOPRISM_LOG_LEVEL: "info"                   # log level: trace, debug, info, warning, or error
      PHOTOPRISM_READONLY: "false"                   # do not modify originals directory (reduced functionality)
      PHOTOPRISM_EXPERIMENTAL: "false"               # enables experimental features
--- a/setup/docker/macos/compose.yaml
+++ b/setup/docker/macos/compose.yaml
@ -80,9 +80,10 @@ services:
      PHOTOPRISM_DATABASE_NAME: "photoprism"         # MariaDB database, see MARIADB_DATABASE in the mariadb service
      PHOTOPRISM_DATABASE_USER: "photoprism"         # MariaDB database username, must be the same as MARIADB_USER
      PHOTOPRISM_DATABASE_PASSWORD: "insecure"       # MariaDB database password, must be the same as MARIADB_PASSWORD
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: ""                # meta site description
-      PHOTOPRISM_SITE_AUTHOR: ""                     # meta site author
+      PHOTOPRISM_SITE_NAME: ""                       # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"  # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: ""                # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: ""                     # site owner shown in the author meta tag
      ## Run/install on first startup, see https://github.com/photoprism/photoprism/blob/develop/scripts/dist/Makefile:
      PHOTOPRISM_INIT: "https tensorflow"            # common options: update https tensorflow tensorflow-gpu intel gpu davfs yt-dlp
      ## Computer Vision (https://docs.photoprism.app/getting-started/config-options/#computer-vision):
--- a/setup/docker/nvidia/compose.yaml
+++ b/setup/docker/nvidia/compose.yaml
@ -57,10 +57,11 @@ services:
      PHOTOPRISM_DEFAULT_LOCALE: "en"                # default user interface language, e.g. "en" or "de"
      PHOTOPRISM_PLACES_LOCALE: "local"              # location details language, e.g. "local", "en", or "de"
      PHOTOPRISM_SITE_URL: "http://localhost:2342/"  # server URL in the format "http(s)://domain.name(:port)/(path)"
-      PHOTOPRISM_SITE_TITLE: "PhotoPrism"
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: ""                # meta site description
-      PHOTOPRISM_SITE_AUTHOR: ""                     # meta site author
+      PHOTOPRISM_SITE_NAME: ""                       # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_TITLE: "PhotoPrism"            # main title shown in the web interface and meta tags
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"  # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: ""                # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: ""                     # site owner shown in the author meta tag
      PHOTOPRISM_LOG_LEVEL: "info"                   # log level: trace, debug, info, warning, or error
      PHOTOPRISM_READONLY: "false"                   # do not modify originals directory (reduced functionality)
      PHOTOPRISM_EXPERIMENTAL: "false"               # enables experimental features
--- a/setup/docker/scheduler/compose.yaml
+++ b/setup/docker/scheduler/compose.yaml
@ -84,9 +84,10 @@ services:
      PHOTOPRISM_DATABASE_NAME: "photoprism"         # MariaDB database, see MARIADB_DATABASE in the mariadb service
      PHOTOPRISM_DATABASE_USER: "photoprism"         # MariaDB database username, must be the same as MARIADB_USER
      PHOTOPRISM_DATABASE_PASSWORD: "insecure"       # MariaDB database password, must be the same as MARIADB_PASSWORD
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: ""                # meta site description
-      PHOTOPRISM_SITE_AUTHOR: ""                     # meta site author
+      PHOTOPRISM_SITE_NAME: ""                       # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"  # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: ""                # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: ""                     # site owner shown in the author meta tag
      ## Run/install on first startup, see https://github.com/photoprism/photoprism/blob/develop/scripts/dist/Makefile:
      PHOTOPRISM_INIT: "https tensorflow"            # common options: update https tensorflow tensorflow-gpu intel gpu davfs yt-dlp
      ## Computer Vision (https://docs.photoprism.app/getting-started/config-options/#computer-vision):
--- a/setup/docker/sqlite/compose.yaml
+++ b/setup/docker/sqlite/compose.yaml
@ -77,9 +77,10 @@ services:
      PHOTOPRISM_UPLOAD_LIMIT: 5000                  # maximum size of uploaded files and uncompressed archive contents in MB
      PHOTOPRISM_ORIGINALS_LIMIT: 5000               # maximum size of original media files in MB (larger files are skipped)
      PHOTOPRISM_DATABASE_DRIVER: "sqlite"           # SQLite is an embedded database that does not require a separate database server
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: ""                # meta site description
-      PHOTOPRISM_SITE_AUTHOR: ""                     # meta site author
+      PHOTOPRISM_SITE_NAME: ""                       # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"  # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: ""                # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: ""                     # site owner shown in the author meta tag
      ## Run/install on first startup, see https://github.com/photoprism/photoprism/blob/develop/scripts/dist/Makefile:
      PHOTOPRISM_INIT: "https tensorflow"            # common options: update https tensorflow tensorflow-gpu intel gpu davfs yt-dlp
      ## Computer Vision (https://docs.photoprism.app/getting-started/config-options/#computer-vision):
--- a/setup/docker/windows/compose.yaml
+++ b/setup/docker/windows/compose.yaml
@ -87,9 +87,10 @@ services:
      PHOTOPRISM_DATABASE_NAME: "photoprism"         # MariaDB database, see MARIADB_DATABASE in the mariadb service
      PHOTOPRISM_DATABASE_USER: "photoprism"         # MariaDB database username, must be the same as MARIADB_USER
      PHOTOPRISM_DATABASE_PASSWORD: "insecure"       # MariaDB database password, must be the same as MARIADB_PASSWORD
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: ""                # meta site description
-      PHOTOPRISM_SITE_AUTHOR: ""                     # meta site author
+      PHOTOPRISM_SITE_NAME: ""                       # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"  # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: ""                # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: ""                     # site owner shown in the author meta tag
      ## Computer Vision (https://docs.photoprism.app/getting-started/config-options/#computer-vision):
      PHOTOPRISM_VISION_API: "false"                 # server: enables service API endpoints under /api/v1/vision (requires access token)
      PHOTOPRISM_VISION_URI: ""                      # client: service URI, e.g. http://hostname/api/v1/vision (leave blank to disable)
--- a/setup/podman/docker-compose.yml
+++ b/setup/podman/docker-compose.yml
@ -94,9 +94,10 @@ services:
      PHOTOPRISM_DATABASE_NAME: "photoprism"         # MariaDB database, see MARIADB_DATABASE in the mariadb service
      PHOTOPRISM_DATABASE_USER: "photoprism"         # MariaDB database username, must be the same as MARIADB_USER
      PHOTOPRISM_DATABASE_PASSWORD: "insecure"       # MariaDB database password, must be the same as MARIADB_PASSWORD
-      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
-      PHOTOPRISM_SITE_DESCRIPTION: ""                # meta site description
-      PHOTOPRISM_SITE_AUTHOR: ""                     # meta site author
+      PHOTOPRISM_SITE_NAME: ""                       # short name for identifying this instance within a cluster
+      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"  # short caption or tagline shown alongside the title
+      PHOTOPRISM_SITE_DESCRIPTION: ""                # longer description shown in SEO and social meta tags
+      PHOTOPRISM_SITE_AUTHOR: ""                     # site owner shown in the author meta tag
      ## Run/install on first startup, see https://github.com/photoprism/photoprism/blob/develop/scripts/dist/Makefile:
      PHOTOPRISM_INIT: "https tensorflow"            # common options: update https tensorflow tensorflow-gpu intel gpu davfs yt-dlp
      ## Video Transcoding (https://docs.photoprism.app/getting-started/advanced/transcoding/):