MicroSD Image for the Raspberry Pi¶
The easiest way to run PhotoPrism on a Raspberry Pi is with PhotoPrismPi.1 Simply flash the image to an SD card and boot your device with it.
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 GitHub:
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
/srv/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.
Based on Ubuntu Server 22.04 and CustomPiOS by Guy Sheffer. ↩
Download and installation time depends on the speed of your Internet connection. ↩
If you can't connect, try using the existing hostname or IP address instead. ↩