AI-Powered Photos App for the Decentralized Web
Find a file
Michael Mayer 378d4746ad Docs: Update README.md
Signed-off-by: Michael Mayer <michael@photoprism.app>
2023-06-02 20:17:13 +02:00
.github CI: Update codeql-analysis.yml 2023-05-10 15:32:42 +02:00
assets Templates: Update error 404 "not found" page styles 2023-06-01 16:36:21 +02:00
cmd/photoprism CLI: Add photoprism connect command 2023-03-24 19:35:29 +01:00
docker Build: Update author and copyright notices 2023-05-01 12:28:55 +02:00
frontend Frontend: Set page title on the search page based on site config #3439 2023-06-02 12:42:20 +02:00
internal Config: Make PhotoPrism compatible with MariaDB 11 #3443 2023-06-02 17:07:10 +02:00
pkg Txt: Update tests in empty_test.go #3412 2023-05-17 20:37:57 +02:00
scripts Scripts: Add usage comment to dist/install-firewall.sh 2023-05-17 23:39:11 +02:00
setup Config: Make PhotoPrism compatible with MariaDB 11 #3443 2023-06-02 17:07:10 +02:00
.clabot CI: Add initial .clabot config file 2022-03-11 19:54:39 +01:00
.dockerignore Icons: Extend render scripts with additional types and formats 2022-10-19 05:11:16 +02:00
.drone.yml Docker: Change "docker-compose" command to "docker compose" #1192 2022-11-05 16:31:08 +01:00
.fossa.yml Links: Change https://photoprism.app/ to https://www.photoprism.app/ 2023-02-08 09:07:42 +01:00
.gitignore CI: Update .gitignore 2023-02-01 16:06:40 +01:00
.ldap.cfg Auth: Refactor user roles and auth providers in entity model #98 2023-03-13 16:04:37 +01:00
.my.cnf
CODE_OF_CONDUCT.md Config: Make options available to all users 2023-05-13 16:02:49 +02:00
codecov.yml
CONTRIBUTING.md Logs: Replace "..." with "…" in info messages 2023-03-28 14:42:19 +02:00
docker-compose.ci.yml Config: Make PhotoPrism compatible with MariaDB 11 #3443 2023-06-02 17:07:10 +02:00
docker-compose.latest.yml Docker: Update docker-compose.yml config examples 2023-04-29 15:22:19 +02:00
docker-compose.local.yml Docker: Update docker-compose.yml config examples 2023-04-29 15:22:19 +02:00
docker-compose.mariadb.yml Config: Make PhotoPrism compatible with MariaDB 11 #3443 2023-06-02 17:07:10 +02:00
docker-compose.mysql.yml Develop: Add "FOR TEST AND DEVELOPMENT ONLY" warning to config files 2022-11-04 12:20:26 +01:00
docker-compose.postgres.yml Docker: Update docker-compose.yml config examples 2023-04-29 15:22:19 +02:00
docker-compose.yml Config: Make PhotoPrism compatible with MariaDB 11 #3443 2023-06-02 17:07:10 +02:00
Dockerfile Develop: Update base image from 230425-lunar to 230516-lunar 2023-05-16 12:13:42 +02:00
FUNDING.yml Update FUNDING.yml 2023-05-30 14:40:41 +02:00
go.mod Backend: Update Go dependencies 2023-06-01 16:35:07 +02:00
go.sum Backend: Update Go dependencies 2023-06-01 16:35:07 +02:00
LICENSE Links: Change https://photoprism.app/ to https://www.photoprism.app/ 2023-02-08 09:07:42 +01:00
Makefile CI: Update Makefile 2023-05-01 11:48:44 +02:00
NOTICE Update third-party licenses in NOTICE file 2023-05-01 12:35:26 +02:00
README.md Docs: Update README.md 2023-06-02 20:17:13 +02:00
SECURITY.md Update SECURITY.md 2022-06-19 18:21:37 +02:00
SPONSORS.md Docs: Add link to Membership FAQ to README.md and SPONSORS.md 2023-05-30 14:50:30 +02:00

PhotoPrism: Browse Your Life in Pictures

License: AGPL GitHub contributors Documentation Community Chat GitHub Discussions Twitter Reddit

PhotoPrism® is an AI-Powered Photos App for the Decentralized Web. It makes use of the latest technologies to tag and find pictures automatically without getting in your way. You can run it at home, on a private server, or in the cloud.

To get a first impression, you are welcome to play with our public demo. Be careful not to upload any private pictures.

Feature Overview

Our mission is to provide the most user- and privacy-friendly solution to keep your pictures organized and accessible. That's why PhotoPrism was built from the ground up to run wherever you need it, without compromising freedom, privacy, or functionality:

Being completely self-funded and independent, we can promise you that we will never sell your data and that we will always be transparent about our software and services. Your data will never be shared with Google, Amazon, Microsoft or Apple unless you intentionally upload files to one of their services. 🔒

Getting Started

Step-by-step installation instructions for our self-hosted community edition can be found on docs.photoprism.app - all you need is a Web browser and Docker to run the server. It is available for Mac, Linux, and Windows.

The stable version and development preview have been built into a single multi-arch image for 64-bit AMD, Intel, and ARM processors. That means, Raspberry Pi 3 / 4 owners can pull from the same repository, enjoy the exact same functionality, and can follow the regular installation instructions after going through a short list of requirements.

Existing users are advised to update their docker-compose.yml config based on our examples available at dl.photoprism.app/docker.

Support Our Mission 💎

PhotoPrism is 100% self-funded and independent. Your continued support helps us provide more features to the public, release regular updates, and remain independent!

Our members enjoy additional features, including access to interactive world maps, and can join our private chat room to connect with our team. We currently have the following membership options:

  • You can sign up directly on our website and pay with credit card or SEPA through Stripe, so you don't need to link an external account and can easily upgrade or downgrade at any time
  • Alternatively, Patreon also supports PayPal, additional currencies, and lets you choose between monthly and annual billing for all tiers

If you currently support us through GitHub Sponsors, you can also register on our website and use the Activate GitHub Sponsors Membership button to link your account. For details on this and how to link your Patreon account, see our Activation Guide.

You are welcome to contact us for change requests, membership questions, and business partnerships.

View Membership FAQ Sign Up

Why Your Support Matters

  • Your continued support helps us provide regular updates and remain independent, so we can fulfill our mission and protect your privacy
  • Sustained funding is key to quickly releasing new features requested by you and other community members
  • Being self-funded and independent, we can personally promise you that we will never sell your data and that we will always be transparent about our software and services

Please also leave a star on GitHub if you like this project. It provides additional motivation to keep going.

A big thank you to all current and past sponsors, whose generous support has been and continues to be essential to the success of the project!

View Sponsors View Credits

Getting Support

Visit docs.photoprism.app/user-guide to learn how to sync, organize, and share your pictures. 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. Eligible members are also welcome to email us for technical support and personalized advice.

Upcoming Features and Enhancements

Our Project Roadmap shows what tasks are in progress and what features will be implemented next. You are invited to give ideas you like a thumbs-up, so we know what's most popular.

Be aware that we have a zero-bug policy and do our best to help users when they need support or have other questions. This comes at a price though, as we can't give exact release dates for new features. Our team receives many more requests than can be implemented, so we want to emphasize that we are in no way obligated to implement the features, enhancements, or other changes you request. We do, however, appreciate your feedback and carefully consider all requests.

Because sustained funding is key to quickly releasing new features, we encourage you to support our mission by signing up as a sponsor or purchasing a commercial license. Ultimately, that's what's best for the product and the community.

GitHub Issues ⚠️

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. Thank you for your careful consideration!

  • When reporting a problem, always include the software versions you are using and other information about your environment such as browser, browser plugins, operating system, storage type, memory size, and processor
  • Note that all issue subscribers receive an email notification from GitHub whenever a new comment is added, so these should only be used for sharing important information and not for discussions, questions or expressing personal opinions
  • 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
  • This gives our team the opportunity to improve the docs and provide best-in-class support to you, instead of handling unclear/duplicate bug reports or triggering a flood of notifications by responding to comments

Connect with the Community

Follow us on Twitter and join the Community Chat to get regular updates, connect with other users, and discuss your ideas. Our Code of Conduct explains the "dos and donts" when interacting with other community members.

Feel free to contact us at hello@photoprism.app with anything that is on your mind. We appreciate your feedback! Due to the high volume of emails we receive, our team may be unable to get back to you immediately. We do our best to respond within five business days or less.

Every Contribution Makes a Difference

We welcome contributions of any kind, including blog posts, tutorials, testing, writing documentation, and pull requests. Our Developer Guide contains all the information necessary for you to get started.


PhotoPrism® is a registered trademark. By using the software and services we provide, you agree to our Terms of Service, Privacy Policy, and Code of Conduct. Docs are available under the CC BY-NC-SA 4.0 License; additional terms may apply.