Skip to content

Getting Updates

Our stable version and development preview now come as a single multi-arch image for AMD64, ARM64, and ARMv7. That means you don't need to pull from different Docker repositories anymore. We recommend updating your existing docker-compose.yml config based on our examples.

Back us on Patreon or GitHub Sponsors. Your continued support helps us provide services like satellite maps and develop new features. Thank you very much! 💜

Docker Compose

Open a terminal and change to the folder in which the docker-compose.yml file has been saved. Now run the following commands to pull the most recent image from Docker Hub and restart your instance in the background:

docker-compose pull photoprism
docker-compose stop photoprism
docker-compose up -d photoprism

Pulling a new version can take several minutes, depending on your internet connection speed.

Advanced users may put this into a Makefile so that they only need to type a single command.

See Setup Using Docker Compose for a command reference.

You can test our latest features and improvements by changing the image from photoprism/photoprism:latest to photoprism/photoprism:preview in your docker-compose.yml. Then pull the most recent image and restart your instance.

Facial Recognition

Existing users may index faces without performing a complete rescan:

docker-compose exec photoprism photoprism faces index

Remove existing people and faces for a clean start e.g. after upgrading from our development preview:

docker-compose exec photoprism photoprism faces reset -f


Adding Watchtower as a service to your docker-compose.yml will automatically keep images up-to-date:

    image: containrrr/watchtower
    restart: unless-stopped
      - "/var/run/docker.sock:/var/run/docker.sock"

Users of our DigitalOcean 1-Click App have Watchtower pre-installed.


Automatic updates may interrupt indexing and import operations. Only enable Watchtower if you are comfortable with this.

Pure Docker

Open a terminal on your server, and run the following command to pull the most recent container image:

docker pull photoprism/photoprism:latest

See Running PhotoPrism with Docker for a command reference.

You can test our latest features and improvements by using photoprism/photoprism:preview instead of photoprism/photoprism:latest.