MicroSD Image for the Raspberry Pi¶
We recommend using a fast MicroSD card with at least 64 GB so that you don't run out of storage space later on. These are usually sold with an adapter that fits into normal SD card slots.
Step 1: Install balenaEtcher¶
Etcher is a powerful OS image flasher that makes flashing an SD card a pleasant and safe experience. You can download it from the official website or directly from GitHub.
- Homepage: https://www.balena.io/etcher/
- Intel / AMD: https://github.com/balena-io/etcher/releases
- Apple Silicon: https://github.com/Augmentedjs/balena-io-etcher-builds/releases
Step 2: Flash from URL¶
Open balenaEtcher and enter the following URL as image source:
When you have selected the image and inserted a suitable card into your computer, press Flash!.
Step 3: Boot Your Device¶
Insert the MicroSD card into the Pi, make sure your device is connected to a wired network, and turn it on. After a few minutes,2 our latest release should be ready to use when you navigate to http://photoprismpi.local/!3
When you first log in to PhotoPrism, the username for the initial super admin account is
admin and the password is
You can also connect to the server via SSH with the username
ubuntu and password
Both passwords should be changed immediately if your Pi is connected to a public network, as they can be easily guessed.
Uploads, sidecar and cache files are stored in
/opt/photoprism. External drives can be connected via USB and accessed as folders
/mnt/d without further configuration.
Should you want to make changes to the default settings, you can find the
docker-compose.yml file in
After connecting via SSH with the credentials provided above, you can obtain root privileges by running
Caddy is installed as a reverse proxy that can be configured in
/etc/caddy/Caddyfile. By default, the automatically generated certificates are not recognized as valid by browsers, so you will see a warning when connecting over HTTPS.