Setup Using Docker Compose¶
To simplify running PhotoPrism on a server, we strongly recommend using Docker Compose.
An image for the Raspberry Pi is available as well. In addition, we plan to provide a single binary.
Step 1: Configure¶
Your personal photo and video collection will be mounted from
~/Pictures by default,
~ is a placeholder for your home directory.
We'll refer to this as the originals folder.
You may mount any folder accessible from your computer, including network drives.
Note that PhotoPrism won't be able to see folders that have not been mounted.
Multiple folders can be indexed by mounting them as sub-folders of
volumes: - "~/Family:/photoprism/originals/Family" - "~/Friends:/photoprism/originals/Friends"
The import folder points to
~/PhotoPrism/Import by default, so that you can easily access it.
If you don't need this feature, e.g. because you manage all files manually or
use a different tool for importing, you can safely remove the volume. Using import is strictly
Settings, index, sidecar files, and thumbnails will be stored in
~/PhotoPrism/Storage by default.
You may use an anonymous volume instead, just don't remove
it completely so that you don't lose your index and albums after restarting or upgrading the container.
Your original media files won't be deleted, modified, or moved.
If you still want to enable the read-only mode, you can do so by setting
It will disable all features that require write permissions, like importing files via Web upload.
You may additionally want to mount the originals folder with
:ro flag so that Docker
blocks write operations.
Step 2: Start the server¶
Open a terminal, go to the folder in which you saved the config file and run this command to start the server:
docker-compose up -d
Now open http://localhost:2342/ in a Web browser to see the user interface.
The initial password is "photoprism". You can change it in Settings or using
photoprism passwd command in a terminal.
The port and other basic settings can be changed in
Remember to stop and re-create the container whenever configuration values changed:
docker-compose stop photoprism docker-compose up -d --no-deps photoprism
To also update the Docker image:
docker-compose pull photoprism docker-compose stop photoprism docker-compose up -d --no-deps photoprism
Be aware that later builds may expect more or different configuration values.
We always keep our example configuration up to date for reference.
In addition, you can run
photoprism help inside the container to see all options incl.
environment variable names and a short description.
Step 3: 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-compose exec photoprism photoprism index
While indexing, a JPEG sidecar file may automatically be created for RAW, HEIF, TIFF, PNG, BMP, and GIF files. It is required for classification and resampling. By default, it will be created in the storage folder, so that your originals can be mounted read-only. You may configure PhotoPrism to store it in the same folder, next to the original, instead.
Pictures will become visible one after another. You can watch the indexer working in the terminal, or the Logs tab in Library.
If you're running out of memory while indexing, it often helps to limit the
number of workers by setting
an explicit value for
Make sure the server has swap
configured so that indexing doesn't stop when there are memory usage spikes.
As a measure of last resort, you may additionally disable image classification using TensorFlow.
photoprism index --all will re-index all originals, including already indexed and unchanged files. This may be
necessary after upgrading, especially to new major versions.
To import files, run
photoprism import after putting them in the import folder:
docker-compose exec photoprism photoprism import
For a list of commands and config options run:
docker-compose exec photoprism photoprism help
Your photos and videos can now be browsed, organized in albums, and shared with others.
You may continue using your favorite tools, like Photoshop or Lightroom,
to edit, add and delete files in the originals folder.
photoprism index, or go to Library and click Start, to update the index as needed.
Easy, isn't it?