photoprism/docker/examples/arm64
2021-01-01 19:54:04 +01:00
..
docker-compose.yml Config: Update docker-compose.yml examples 2021-01-01 19:54:04 +01:00
README.md Config: Update docker-compose.yml examples 2021-01-01 19:54:04 +01:00

PhotoPrism for Raspberry Pi (64bit)

Big thank you to Guy Sheffer for building this!

Download our docker-compose.yml file (right click and Save Link As... or use wget) to a folder of your choice, change the configuration as needed, and run sudo docker-compose up to start PhotoPrism:

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

The default port 2342 and other configuration values may be changed as needed, see Setup Using Docker Compose and Config Options for details.

Our repository on Docker Hub: https://hub.docker.com/r/photoprism/photoprism-arm64

!!! attention Please change PHOTOPRISM_ADMIN_PASSWORD so that PhotoPrism starts with a secure initial password. Never use photoprism or insecure as password if you're running it on a public server.

Docker Compose Command Reference

Please prefix with sudo if your current user doesn't have permission to run Docker commands:

Action Command
Update docker-compose pull photoprism
Stop docker-compose stop photoprism
Start docker-compose up -d photoprism
Logs docker-compose logs --tail=25 -f
Terminal docker-compose exec photoprism bash
Help docker-compose exec photoprism photoprism help
Config docker-compose exec photoprism photoprism config
Reset docker-compose exec photoprism photoprism reset
Backup docker-compose exec photoprism photoprism backup -a -i
Restore docker-compose exec photoprism photoprism restore -a -i
Import docker-compose exec photoprism photoprism import
Index docker-compose exec photoprism photoprism index
Reindex docker-compose exec photoprism photoprism index -a

System Requirements

You need to boot your Raspberry Pi 3/4 with the parameter arm_64bit=1 in config.txt in order to use this image. Alternatively, you can run the image on UbuntuDockerPi. It's a 64bit Ubuntu Server with Docker pre-installed.

Indexing large photo and video collections significantly benefits from fast, local SSD storage and enough memory for caching.

!!! tip "Reducing Server Load" If you're running out of memory - or other system resources - while indexing, please limit the number of workers by setting PHOTOPRISM_WORKERS to a value less than the number of logical CPU cores in docker-compose.yml. Also make sure your server has swap configured so that indexing doesn't cause restarts when there are memory usage spikes. As a measure of last resort, you may additionally disable image classification using TensorFlow.

To avoid permission issues, docker-compose.yml should include the following security options:

  photoprism:
    security_opt:
      - seccomp:unconfined
      - apparmor:unconfined

Additional Documentation