PhotoPrism® Helm Charts

Our public Helm charts for deploying PhotoPrism on Kubernetes can be found at /photoprism. Customers with a private repository require basic authentication under /<name>. We recommend pinning --version for production installs and storing credentials in Kubernetes Secrets or CI secret stores.

Use in Rancher

Platform Guide

PhotoPrism Charts

  1. Open ☰ Cluster › Explore › Apps › Repositories › Create.
  2. Choose HTTP/HTTPS repository.
  3. Set Index URL to https://charts.photoprism.app/photoprism.
  4. Click Create. Charts appear under Apps › Charts.

Private Repositories

  1. Choose HTTP/HTTPS repository.
  2. Set Index URL to your private repository name, e.g. https://charts.photoprism.app/<name>.
  3. Enable Authentication and provide the username/token supplied by PhotoPrism.
  4. Create. You will see only the charts licensed to your account.
If your cluster uses a custom CA, add the CA bundle in Rancher when creating the repository.

Helm CLI

helm repo add photoprism https://charts.photoprism.app/photoprism
helm repo update
helm search repo photoprism
# Install PhotoPrism® Plus (personal edition):
helm install photoprism-plus photoprism/photoprism-plus --version <version> \
  --namespace photos --create-namespace
# Or install PhotoPrism® Pro (for teams and organizations):
# helm install photoprism-pro photoprism/photoprism-pro --version <version>
# Upgrade later:
helm upgrade photoprism-plus photoprism/photoprism-plus --version <version>
# helm upgrade photoprism-pro photoprism/photoprism-pro --version <version>

Private Repositories

# Method 1: Embed credentials once (shell history may expose them)
helm repo add <name> https://charts.photoprism.app/<name> --username <user> --password <token>

# Method 2: Use a netrc file (preferred on CI)
# ~/.netrc
machine charts.photoprism.app
  login <user>
  password <token>

helm repo add <name> https://charts.photoprism.app/<name>
helm repo update
helm install photoprism acme/photoprism --version <version>
Store credentials securely. Avoid pasting tokens directly into CI logs or shell history.

Use in OpenShift

Platform Guide

OpenShift Web Console

  1. Switch to the Developer perspective and open Helm › Chart Repositories.
  2. Click Add Repository (or Create depending on your OpenShift version).
  3. Set the repository URL to https://charts.photoprism.app/photoprism.
  4. Save, then install from Helm › Charts.

Private Repositories

  1. Use your private URL, e.g. https://charts.photoprism.app/<name>.
  2. Create a Secret that stores your repository username and token.
  3. Attach that Secret to the chart repository in the OpenShift UI.
  4. Install and upgrade with a pinned chart version in production.

CLI Workflow (oc + helm)

# Create / select a target project
oc new-project photos

# Add the PhotoPrism chart repository
helm repo add photoprism https://charts.photoprism.app/photoprism
helm repo update

# Install a pinned chart version
helm install photoprism-plus photoprism/photoprism-plus --version <version> \
  --namespace photos --create-namespace

# Upgrade later
helm upgrade photoprism-plus photoprism/photoprism-plus --version <version>

Private Repository Example

helm repo add <name> https://charts.photoprism.app/<name> \
  --username <user> --password <token>
helm repo update
Keep repository tokens in Secrets or CI secret stores instead of plaintext manifests.

Endpoints

  • Index: https://charts.photoprism.app/photoprism/index.yaml
  • PhotoPrism Charts: https://charts.photoprism.app/photoprism/
  • Private Repositories: https://charts.photoprism.app/<name>/