Skip to content

Setup

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 getting continuously updated in the navigation.

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

Roadmap

Our vision is to provide the most user-friendly solution for browsing, organizing, and sharing your photo collection. The 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 eligible sponsors will be prioritized as well.

System Requirements

We recommend hosting PhotoPrism on a server with at least 2 cores and 4 GB of memory. Beyond these minimum requirements, the amount of RAM should match the number of cores. Indexing large photo and video collections significantly benefits from fast, local SSD storage.

If you're running out of memory - or other system resources - while indexing, please reduce the number of workers to a value less than the number of logical CPU cores. Also make sure your server has swap configured, so that indexing doesn't cause restarts when there are memory usage spikes. As a measure of last resort, you may additionally disable image classification using TensorFlow.

Our Web UI works with most modern browsers, and runs best on Chrome, Chromium, Safari, Firefox, and Edge. Opera and Samsung Internet have been reported to be compatible as well. Note that not all video formats may be played with every browser.

The backend is compatible with MariaDB 10, MySQL 8, and SQLite 3.

Attention

When installing PhotoPrism on a public server outside your home network, please always run it behind a secure HTTPS reverse proxy like Traefik, Caddy, 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. Backup tools and file sync apps like FolderSync may refuse to connect as well.