How to install PhotoPrism on Linux Mint

PhotoPrism is an open-source photo management application that lets you store, organize, and share your photos from anywhere. It supports advanced features like face detection, automatic tagging, and image quality adjustment. In this tutorial, we will show you how to install PhotoPrism on Linux Mint.

Prerequisites

• A Linux Mint system with a non-root user with sudo privileges.
• Docker and Docker-compose installed on your system.

Step 1: Install Docker

To install Docker, update the apt package index, install the required packages, and add the Docker GPG key to your system using the following commands:

sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io -y

After installation, you can check the status of Docker with:

sudo systemctl status docker

Step 2: Install Docker Compose

Docker Compose is a tool for defining and running complex multi-container Docker applications. You can install it using the following commands:

sudo curl -L "https://github.com/docker/compose/releases/download/1.26.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Verify the installation with the following command:

docker-compose --version

Step 3: Install PhotoPrism

1. Create a working directory and navigate to it.

mkdir photoprism
cd photoprism

2. Create a docker-compose.yaml file with the following command:

nano docker-compose.yaml

3. Copy the following code into the file and save it.

version: '3.4'

services:
  photoprism:
    image: photoprism/photoprism
    restart: unless-stopped
    container_name: photoprism
    ports: 
      - "2342:2342"
    environment:
      - PHOTOPRISM_ADMIN_PASSWORD=<enter a secure password>
      - PHOTOPRISM_STORAGE_LOCATION=/data/
      - PHOTOPRISM_ORIGINALS_DIR=/data/originals/
      - PHOTOPRISM_IMPORT_DIR=/data/import/
      - PHOTOPRISM_DATABASE_FILE=/data/photoprism.db
      - PHOTOPRISM_EXIFTOOL_PATH=/usr/bin/exiftool
      - PHOTOPRISM_FFMPEG_PATH=/usr/bin/ffmpeg
      - PHOTOPRISM_CONVERT_PATH=/usr/bin/convert
    volumes:
      - /mnt/photoprism:/data/

4. Change the PHOTOPRISM_ADMIN_PASSWORD value to a secure password that you will remember.

5. Create a directory on your system where you will store your photos. For example:

sudo mkdir /mnt/photoprism

6. Run the following command in your working directory to start the PhotoPrism container:

sudo docker-compose up -d

This will start the PhotoPrism container in detached mode which means that it will run in the background.

7. Wait for the container to start up and open http://localhost:2342 in your browser. You should see the PhotoPrism login screen.

8. Enter the admin password that you set in the docker-compose.yaml file and click "Login".

9. You can now import your photos into PhotoPrism by going to the "Import" tab and selecting the directory that contains your photos.

Congratulations! You have successfully installed PhotoPrism on Linux Mint. You can now start managing your photos with this powerful photo management application.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!