PhotoPrism is a self-hosted platform that helps you manage and organize your photos on a private server. It keeps your photos saved by storing them in your home folder only. It works similar to Google Photos but includes additional features such as identifying duplicate photos, removing noise from the images, securing photo-sharing and much more.

In this article, you will find the method to set up PhotoPrism on Raspberry Pi.

Setup PhotoPrism on Raspberry Pi

To setup PhotoPrism on Raspberry Pi, you will need to execute the below-mentioned steps:

Step 1: Update Raspberry Pi Packages

Ensure the packages on the Raspberry Pi are updated using the following command:

$ sudo apt update && sudo apt upgrade

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-1.png" data-lazy- height="451" src="data:image/svg xml,” width=”776″>

Step 2: Install Docker and Docker Compose

In this step, you will require installing Docker and Docker compose on your Raspberry Pi, as this will allow you to configure the PhotPrism and enable us to use all software services through a single command.

To install Docker, execute the following curl command:

$ curl -fsSL https://get.docker.com -o get-docker.sh

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-2.png" data-lazy- height="82" src="data:image/svg xml,” width=”774″>

Then use the following sudo command to get the Docker on Raspberry Pi.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-3.png" data-lazy- height="75" src="data:image/svg xml,” width=”955″>

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-4.png" data-lazy- height="552" src="data:image/svg xml,” width=”953″>

After the installation, you can check the docker version by using the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-5.png" data-lazy- height="82" src="data:image/svg xml,” width=”952″>

Next, to install Docker compose on Raspberry Pi, issue the following command:

$ sudo apt install docker-compose

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-6.png" data-lazy- height="482" src="data:image/svg xml,” width=”950″>

Step 3: Enable Raspberry Pi OS 64-Bit Kernel

Next, we need to enable the 64-bit kernel on Raspberry Pi OS. However, before doing this operation, first, check the kernel version using the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-7.png" data-lazy- height="111" src="data:image/svg xml,” width=”953″>

From the above command, we will see that our Raspberry Pi uses armv7l which is a 32-bit architecture. Now to change this, open the configuration file using the below-mentioned command:

$ sudo nano /boot/config.txt

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-8.png" data-lazy- height="552" src="data:image/svg xml,” width=”956″>

Add the following line at the end of the document:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-9.png" data-lazy- height="550" src="data:image/svg xml,” width=”954″>

Save the file using the “Ctrl X” keys together, add “Y” and press Enter.

Reboot the device to make the changes.

After the device reboots, check the architecture again using the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-10.png" data-lazy- height="105" src="data:image/svg xml,” width=”953″>

The above screenshot ensures that Raspberry Pi OS includes the 64-bit version.

Step 4: Install PhotoPrism

Now, to install PhotoPrism, first create a directory of PhotoPrism using the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-11.png" data-lazy- height="70" src="data:image/svg xml,” width=”949″>

Then enter the created directory by using the following command:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-12.png" data-lazy- height="63" src="data:image/svg xml,” width=”951″>

Now, get the docker-compose yml file of PhotoPrism in the created directory by using the following command:

$ wget https://dl.photoprism.org/docker/arm64/docker-compose.yml

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-13.png" data-lazy- height="367" src="data:image/svg xml,” width=”951″>

Step 5: Change Password

After the installation, you will have to change the PhotoPrism admin password from the docker-compose file which can be opened using the following command:

$ nano docker-compose.yml

Identify the below-given line in the file:

PHOTOPRISM_ADMIN_PASSWORD: “insecure”

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-14.png" data-lazy- height="550" src="data:image/svg xml,” width=”957″>

Replace insecure with the password of your choice and save the file.

Step 6: Launch PhotoPrism services

In this step use the following command to start launching PhotoPrism services and set up process:

$ sudo docker-compose up -d

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-15.png" data-lazy- height="371" src="data:image/svg xml,” width=”954″>

Wait till the process completes the installation and when the terminal prompt is back to you, use the following command to check the status of 2 docker containers included in the compose file.

$ sudo docker ps –format “table {{.Names}}t{{.Ports}}t{{.Status}}”

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-16.png" data-lazy- height="140" src="data:image/svg xml,” width=”948″>

If they are running fine, proceed to the next step.

Step 7: Open PhotoPrism Web Interface

In the final step, use your Raspberry Pi IP address to open the PhotoPrism Web interface in the browser tab. To check the IP address, issue the following command in the terminal:

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-17.png" data-lazy- height="74" src="data:image/svg xml,” width=”833″>

Then use the address http://:2342 in the browser to open the PhotoPrism web interface.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-18.png" data-lazy- height="739" src="data:image/svg xml,” width=”1204″>

Use Name as “admin” and type the password you have set in Step 5. Click on the “Sign in” button to proceed.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-19.png" data-lazy- height="735" src="data:image/svg xml,” width=”1201″>

This will open the PhotoPrism dashboard on the browser.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-20.png" data-lazy- height="739" src="data:image/svg xml,” width=”1192″>

Click on the highlighted “upload” in the image below to start uploading your images on the PhotoPrism dashboard.

<img alt="" data-lazy- data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/PhotoPrism-on-Raspberry-Pi-21.png" data-lazy- height="740" src="data:image/svg xml,” width=”1193″>

There are also multiple options available for you on the left side of the interface, where you will be provided with options of uploading videos, creating an album and more. This completes the installation of PhotoPrism on Raspberry Pi.

Conclusion

PhotoPrism is a perfect web photo organizer that can handle your photos or video on a self-hosted platform. The above instructions will assist you in setting up PhotoPrism on Raspberry Pi by first installing Docker and Docker-compose utilities and then changing the architecture to begin the installation of PhotoPrism through the yml docker file. Afterward, you will be able to access the web interface of PhotoPrism on the browser using the IP address of your Raspberry Pi device.

About the author

<img data-del="avatar" data-lazy-src="https://kirelos.com/wp-content/uploads/2022/05/echo/unnamesadadsasdd-150×150.jpg628ef9f1e4821.jpg" height="112" src="data:image/svg xml,” width=”112″>

Awais Khan

I’m an Engineer and an academic researcher by profession. My interest for Raspberry Pi, embedded systems and blogging has brought me here to share my knowledge with others.