Skip to content

Getting Started

To simplify running PhotoPrism on a server, we strongly recommend using Docker Compose. It is available for Mac, Linux and Windows.

Next, you'll have to index your library. Please be patient, this will take a while depending on the size of your photo collection.

Already indexed photos can be browsed in Photos while videos show up in Videos. Counts are continuously updated in the navigation.

If files are missing, they might be in Review due to low quality or missing metadata. You can turn this and other features off in Settings, depending on your specific use case.

Feature Requests

Our roadmap shows what tasks are in progress, what needs testing, and which feature requests are going to be implemented next.

Please give ideas you like a thumbs-up 👍 , so that we know what is most popular. Ideas backed by one or more sponsors will be prioritized as well.

System Requirements

We recommend a modern computer with at least 2 cores and 4 GB of memory for running PhotoPrism. Indexing large photo and video collections significantly benefits from fast, local SSD storage and enough memory for caching.

If you're running out of memory, limit the number of workers and make sure the server has swap configured, so that indexing doesn't stop when there are memory usage spikes. As a measure of last resort, you may additionally disable image classification using TensorFlow.

Attention

When installing PhotoPrism on a public server outside your home network, please always run it behind a secure HTTPS reverse proxy like Caddy, Traefik, or Nginx. Your files and passwords will be transmitted in clear text otherwise, and can be intercepted by anyone in between including your provider, hackers, and governments.