Running PhotoPrism with Docker¶
These instructions are for users who don't like Docker Compose for any reason and prefer pure Docker instead. If you are not sure, try using Docker Compose first.
Step 1: Start the server¶
Open a terminal and run this command after replacing
the folder containing your photos:
docker run -d \ --name photoprism \ -p 2342:2342 \ -v ~/originals:/photoprism/originals \ photoprism/photoprism
Now open http://localhost:2342/ in a Web browser to see the user interface. The default password is "photoprism".
This is a simplified configuration compared to our Docker Compose example:
- The import folder is not mounted so that importing is not possible
- User settings, the thumbnail cache and database files will get stored in
originals/.photoprismunless you configure a separate storage path
The default port 2342 and other configuration values can be changed as needed. Adding the
:ro flag to a volume
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 and display them in a browser. You can enable read-only mode to prevent this completely, but you will also lose the functionality.
Step 2: Index your library¶
Go to Library in our Web UI to start indexing or importing. Alternatively, you can run this command in a terminal to index all files in your originals folder:
docker exec -ti photoprism photoprism index
The index command will automatically create JPEGs from other file types when needed to display them in a browser. They will be stored in the same folder next to the original using the best possible quality. You can disable this in Settings. Converting is currently not possible in read-only mode.
Photos will become visible one after another. You can watch the indexer working in the terminal, or the logs tab in Library.
photoprism index --all will re-index all originals, including already indexed and unchanged files. This can be
useful after updates that add new features.
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