photoprism/docker/examples/arm64/README.md
Michael Mayer e90de9a1d7 Config: Improve Raspberry Pi docs #748
Signed-off-by: Michael Mayer <michael@liquidbytes.net>
2020-12-28 14:43:29 +01:00

3 KiB

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

Update: sudo docker-compose pull photoprism Stop: sudo docker-compose stop photoprism Start: sudo docker-compose up -d photoprism Logs: sudo docker-compose logs --tail=20 Terminal: sudo docker-compose exec photoprism bash Help: sudo docker-compose exec photoprism photoprism help Config: sudo docker-compose exec photoprism photoprism config

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