Skip to content

User Guide

Step-by-step installation instructions for our self-hosted community edition can be found in Getting Started. All you need is a Web browser and Docker to run the server. It is available for Mac, Linux, and Windows. PhotoPrism also runs on PikaPods, DigitalOcean, Raspberry Pi, FreeBSD, and many NAS devices.

Progressive Web App

Once the initial setup is complete, our First Steps 👣 tutorial guides you through the user interface and settings to ensure your library is indexed according to your individual preferences.

Getting Support

If you need help installing our software at home, you can join us on Reddit, ask in our Community Chat, or post your question in GitHub Discussions. Common problems can be quickly diagnosed and solved using the Troubleshooting Checklists in Getting Started.

We'll do our best to answer all your questions. In return, we ask you to back us on Patreon or GitHub Sponsors. Think of "free software" as in "free speech," not as in "free beer". Thank you!

In exchange for their continued support, sponsors are also welcome to request direct technical support via email. Please bear with us if we are unable to get back to you immediately due to the high volume of emails and contact requests we receive.

We kindly ask you not to report bugs via GitHub Issues unless you are certain to have found a fully reproducible and previously unreported issue that must be fixed directly in the app. Contact us or a community member if you need help, it could be a local configuration problem, or a misunderstanding in how the software works.