Step 1: Create a Customer Account
Before you proceed, please make sure you have a customer account with us. You can register using the link you have received from us by email. If you already have an account, we will be happy to assign your licenses to that account or give you a free trial.
Our Privacy Policy explains what information we collect and how we use it. Don't hesitate to contact us if you have any questions about this policy, other privacy-related topics, or the registration process.
Step 2: Upgrade to PhotoPrism® Pro
If you already have our Community Edition installed or are upgrading from PhotoPrism® Plus, you can keep your existing configuration and only need to change the Docker image.
(1) Change the Docker image in your compose.yaml from photoprism/photoprism:latest to photoprism/pro:latest and save your changes:
services:
photoprism:
image: photoprism/pro:latest
When using Portainer you can change the image by navigating to "Stacks", selecting your existing PhotoPrism stack, clicking "Editor" and changing the photoprism image to photoprism/pro:latest as shown above. When you are done, scroll down, click "Update the stack", enable the "re-pull and redeploy" option, click "Update" and skip the next steps.
(2) Restart your instance as follows to complete the upgrade:
docker compose pull
docker compose up -dPhotoPrism® Pro should be ready to use after waiting a few moments, so you can connect to the same URL you have been using before and log in with one of the existing accounts.
Note that the examples in our documentation use the new docker compose command by default. If your server does not yet support it, the old docker-compose command will continue to work.
To verify that all services are running properly, you can view the server logs at any time by running docker compose logs -f.
Step 3: Get Started
Our First Steps 👣 tutorial guides you through the user interface and library settings to ensure your library is indexed according to your individual preferences.
In the following section, we'll give you an overview of the available user roles in PhotoPrism® Pro and show you how to manage accounts.
User Management
In addition to the command-line interface available in all editions, PhotoPrism® Pro includes a web user interface for managing user accounts as well as additional account roles to restrict permissions as needed.
Authenticating Users Against a Directory Server
With the built-in LDAP support, you can authenticate users against a central Lightweight Directory Access Protocol or Active Directory (AD) server so that users on the corporate network can sign in with their existing usernames and passwords.
Using Audit Logs
Audit logs help your security, auditing, and compliance entities monitor PhotoPrism® Pro for potential vulnerabilities, misuse, and other critical incidents.
Hardened Web Security
PhotoPrism® Pro additionally includes advanced security features such as session monitoring (run photoprism auth --help to see the available commands), which allows you to create, inspect and delete access tokens for authenticating browsers and other clients (including app passwords). You can also set a general request rate limit for the built-in web server and a threshold for failed login attempts.
For more information on the available security options, see the Authentication and Web Server sections in our configuration options overview.
Using HTTPS
For HTTPS to work with your own domains, you can either use an HTTPS reverse proxy like Traefik (that you might already have to run other services) or specify a TLS certificate and private key file via PHOTOPRISM_TLS_CERT and PHOTOPRISM_TLS_KEY in your compose.yaml file.
PhotoPrism® Documentation
For detailed information on specific product features, services, and related resources, see our Knowledge Base, or read the User Guide for help using the web user interface:
