For the early birds¶
You are welcome to get an impression and provide early feedback. We've set up a public demo at demo.photoprism.org for you to play with.
Note that this is work in progress. We do our best to provide a complete, stable version. Financial support makes a huge difference and enables us to spend more time with this project.
Leave your email to get a release notification.
Browse your photos¶
Before you start, make sure you have Docker installed on your system. It is available for Mac, Linux and Windows. Developers can skip this and move on to the Developer Guide. It also contains instructions for running our container image via Docker Compose.
In addition, we plan to ship the final app as a single binary for users that don't know or like Docker. An image for the Raspberry Pi is now available too.
Step 1: Start the server¶
Open a terminal and run this command after replacing ~/Pictures with the folder containing your photos:
docker run -d \ --name photoprism \ -p 2342:2342 \ -v ~/Pictures:/home/photoprism/Pictures/Originals \ photoprism/photoprism
The default port 2342 can be changed as needed. Adding a
:ro flag to the
mounts it read only.
Your image files won't be deleted, modified or moved. We might later update metadata in XMP sidecar files to sync with Adobe Lightroom. A JPEG representation might be created for RAW, HEIF, TIFF, PNG, BMP and GIF images in order to render thumbnails. You can enable read-only mode to prevent this completely, but you will also lose the functionality.
Now open http://localhost:2342/ in a Web browser to see the user interface. The default password is "photoprism".
Step 2: Index photos¶
There won't be any search results before you have indexed your photos. You can either do this using our comfortable Web UI or in a terminal:
docker exec -ti photoprism photoprism index
Photos will become visible one after another. You can watch the indexer working in the terminal or the logs tab (Library).
PhotoPrism and Web browsers in general can not display RAW image files. They need to be converted, which is what our import and convert commands do. You'll find a checkbox for this step in our Web UI (disabled in read-only mode).
Due to popular request, our latest demo now also supports TIFF, PNG, BMP and GIF files. Be aware that files in those formats often don't contain useful metadata and are typically used for screenshots, charts, graphs and icons only.
Step 3: When you're done...¶
You can stop the server and start it again using the following commands:
docker stop photoprism docker start photoprism
To remove the container completely:
docker rm -f photoprism
Run our demo¶
For a quick test, you can start a demo that comes with pre-indexed photos:
docker run -p 2342:2342 -d --name demo photoprism/demo
After running the command, open http://localhost:2342/ in a Web browser. It may take a few seconds to become available.
To stop and remove the container:
docker rm -f demo
Open a terminal and run the following command to pull the latest container image:
docker pull photoprism/photoprism:latest
Our database schema still changes a lot as we do performance optimizations and add features. Therefore we cannot provide a smooth upgrade path and you should be prepared to delete your current database and re-index. To spare you a disappointment, we kindly advise you not to index large photo collections at the moment.