Skip to content

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.

Raspberry Pi 5

Since our current MicroSD image is based on Ubuntu 22.04 LTS, it is not yet compatible with the Raspberry Pi 5, which requires Ubuntu 23.10+. As an alternative, you can download Ubuntu 23.10, install Docker, and then follow our regular Setup Guide.

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.

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

User Accounts

When you first log in to PhotoPrism, the username for the initial super admin account is admin and the password is photoprismpi.

You can also connect to the server via SSH with the username ubuntu and password ubuntu.


Since they can be easily guessed, both passwords should be changed immediately. This is especially important if your device is connected to the Internet or any other shared network.

Storage Folders

Uploads, sidecar and cache files are stored in /opt/photoprism. External drives can be connected via USB and accessed as folders /mnt/a to /mnt/d without further configuration.

Should you want to make changes to the default settings, you can find your compose.yaml or docker-compose.yml file in /boot/firmware/docker-compose/photoprism. After connecting via SSH with the credentials provided above, you can obtain root privileges by running sudo -i.


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.

  1. PhotoPrismPi is based on Ubuntu Server and CustomPiOS. Special thanks to Guy Sheffer who helped us build this! 

  2. Download and installation time depends on the speed of your Internet connection. 

  3. If you can't connect, try using the existing hostname or IP address instead.