>> Running PhotoPrism on ARMv7-based devices (32-bit) <<
You may use the following 32-bit Docker images to run PhotoPrism and MariaDB
on ARMv7-based devices:
Stable Release : photoprism/photoprism:armv7
Development Preview: photoprism/photoprism:preview-armv7
MariaDB : linuxserver/mariadb:latest
Docker Hub URL:
https://hub.docker.com/r/photoprism/photoprism/tags?page=1&name=armv7
Note that Darktable is not included in the ARMv7 image because it is not
32-bit compatible. Always choose the regular 64-bit version if your device
supports it.
If your device meets the system requirements, mostly the same installation
instructions as for regular Linux servers apply:
https://docs.photoprism.app/getting-started/docker-compose/
Please pay close attention to changed directory and environment variable names!
Existing users are advised to check their "docker-compose.yml" against our
examples at <dl.photoprism.app/docker> from time to time in case there are new
configuration options or other improvements. Update instructions can be found at
the bottom of this README file.
### System Requirements ###
- Your device should have at least 3 GB of physical memory and a 64-bit operating
system (always use our ARM64 image if possible)
- While PhotoPrism has been reported to work on devices with less memory, we take
no responsibility for instability or performance problems
- RAW image conversion and TensorFlow are disabled on systems with 1 GB or less memory
- Indexing large photo and video collections significantly benefits from local SSD
storage and plenty of memory for caching, especially the conversion of RAW images
and the transcoding of videos are very demanding
- If less than 4 GB of swap space is configured or a manual memory/swap limit is set,
this can cause unexpected restarts, for example, when the indexer temporarily needs
more memory to process large files
- High-resolution panoramic images may require additional swap space and/or physical
memory above the recommended minimum
- We recommend disabling kernel security in your docker-compose.yml, especially if you
do not have experience with the configuration:
```
photoprism:
security_opt:
- seccomp:unconfined
- apparmor:unconfined
```
- If you install PhotoPrism on a public server outside your home network, always run
it behind a secure HTTPS reverse proxy such as Traefik or Caddy:
https://docs.photoprism.app/getting-started/proxies/traefik/
### Troubleshooting ###
If your server runs out of memory, the index is frequently locked, or other
system resources are running low:
- Try reducing the number of workers by setting PHOTOPRISM_WORKERS to a reasonably
small value in docker-compose.yml, depending on the performance of your device
or cloud server:
https://docs.photoprism.app/getting-started/config-options/
- If you are using SQLite, switch to MariaDB, which is better optimized for
high concurrency
- As a last measure, you can disable the use of TensorFlow for image classification
and facial recognition
Other issues? Our troubleshooting checklists help you quickly diagnose and solve them:
https://docs.photoprism.app/getting-started/troubleshooting/
### Getting Updates ###
Open a terminal and change to the folder where the "docker-compose.yml" file
was saved. Now run the following commands to download the most recent image
from Docker Hub and restart your instance in the background:
docker-compose pull --platform=arm photoprism
docker-compose stop photoprism
docker-compose up -d photoprism
Pulling a new version can take several minutes, depending on your internet
connection speed.
Note that running an image with ":latest" tag does not cause Docker to automatically
download new images.
### Credits ###
A big thank you to Guy Sheffer (https://github.com/guysoft) for helping us
build a Raspberry Pi version!
