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. Thank you very much!

Compare Memberships › View Open Source FAQ ›

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.

Membership Activation

To connect a new instance to your membership account, you will need to log in with the admin user that is automatically created during setup, and then follow the steps described in our activation guide.

View Activation Guide › View Membership FAQ ›