2022-03-02 16:13:00 +01:00
|
|
|
|
2022-03-02 16:07:24 +01:00
|
|
|
>> Running PhotoPrism on ARMv7-based devices (32-bit) <<
|
2021-12-10 15:39:16 +01:00
|
|
|
|
2022-03-02 12:21:46 +01:00
|
|
|
You may use the following 32-bit Docker images to run PhotoPrism and MariaDB
|
|
|
|
on ARMv7-based devices:
|
2021-12-10 15:39:16 +01:00
|
|
|
|
2022-03-02 16:07:24 +01:00
|
|
|
Stable Release : photoprism/photoprism:armv7
|
|
|
|
Development Preview: photoprism/photoprism:preview-armv7
|
|
|
|
MariaDB : linuxserver/mariadb:latest
|
2021-12-10 15:39:16 +01:00
|
|
|
|
2022-02-13 16:25:59 +01:00
|
|
|
Docker Hub URL:
|
|
|
|
|
|
|
|
https://hub.docker.com/r/photoprism/photoprism/tags?page=1&name=armv7
|
|
|
|
|
2022-03-02 16:07:24 +01:00
|
|
|
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.
|
2021-12-10 23:01:10 +01:00
|
|
|
|
2022-03-02 12:21:46 +01:00
|
|
|
If your device meets the system requirements, mostly the same installation
|
|
|
|
instructions as for regular Linux servers apply:
|
2021-12-14 23:45:40 +01:00
|
|
|
|
|
|
|
https://docs.photoprism.app/getting-started/docker-compose/
|
2021-12-10 15:39:16 +01:00
|
|
|
|
2022-02-13 16:25:59 +01:00
|
|
|
Please pay close attention to changed directory and environment variable names!
|
|
|
|
|
2022-03-02 16:07:24 +01:00
|
|
|
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.
|
2022-02-20 18:31:16 +01:00
|
|
|
|
2021-12-10 15:39:16 +01:00
|
|
|
### System Requirements ###
|
|
|
|
|
2022-03-02 12:21:46 +01:00
|
|
|
- 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
|
2022-03-02 16:07:24 +01:00
|
|
|
- RAW image conversion and TensorFlow are disabled on systems with 1 GB or
|
|
|
|
less memory
|
2022-03-02 12:21:46 +01:00
|
|
|
- Indexing large photo and video collections significantly benefits from local SSD
|
2022-03-02 16:07:24 +01:00
|
|
|
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:
|
2021-12-10 15:39:16 +01:00
|
|
|
```
|
|
|
|
photoprism:
|
|
|
|
security_opt:
|
|
|
|
- seccomp:unconfined
|
|
|
|
- apparmor:unconfined
|
|
|
|
```
|
2022-03-02 16:07:24 +01:00
|
|
|
- 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:
|
2022-03-02 12:21:46 +01:00
|
|
|
https://docs.photoprism.app/getting-started/proxies/traefik/
|
2021-12-10 15:39:16 +01:00
|
|
|
|
2022-01-27 09:16:10 +01:00
|
|
|
### Troubleshooting ###
|
|
|
|
|
2022-03-02 12:21:46 +01:00
|
|
|
If your server runs out of memory, the index is frequently locked, or other
|
|
|
|
system resources are running low:
|
2022-01-27 09:16:10 +01:00
|
|
|
|
2022-03-02 12:21:46 +01:00
|
|
|
- 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:
|
2022-01-27 09:16:10 +01:00
|
|
|
|
|
|
|
https://docs.photoprism.app/getting-started/config-options/
|
|
|
|
|
2022-03-02 12:21:46 +01:00
|
|
|
- If you are using SQLite, switch to MariaDB, which is better optimized for
|
|
|
|
high concurrency
|
2022-01-27 09:16:10 +01:00
|
|
|
|
2022-03-02 16:07:24 +01:00
|
|
|
- As a last measure, you can disable the use of TensorFlow for image
|
|
|
|
classification and facial recognition
|
2022-01-27 09:16:10 +01:00
|
|
|
|
2022-03-02 16:07:24 +01:00
|
|
|
Other issues? Our troubleshooting checklists help you quickly diagnose and
|
|
|
|
solve them:
|
2022-01-27 09:16:10 +01:00
|
|
|
|
|
|
|
https://docs.photoprism.app/getting-started/troubleshooting/
|
2021-12-10 15:39:16 +01:00
|
|
|
|
2021-12-10 21:32:51 +01:00
|
|
|
### Getting Updates ###
|
|
|
|
|
2022-03-02 12:21:46 +01:00
|
|
|
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:
|
2022-02-20 18:31:16 +01:00
|
|
|
|
|
|
|
docker-compose pull --platform=arm photoprism
|
|
|
|
docker-compose stop photoprism
|
|
|
|
docker-compose up -d photoprism
|
|
|
|
|
2022-03-02 12:21:46 +01:00
|
|
|
Pulling a new version can take several minutes, depending on your internet
|
|
|
|
connection speed.
|
2022-02-20 18:31:16 +01:00
|
|
|
|
2022-03-02 16:07:24 +01:00
|
|
|
Note that running an image with ":latest" tag does not cause Docker to
|
|
|
|
automatically download new images.
|
2021-12-10 21:32:51 +01:00
|
|
|
|
|
|
|
### Credits ###
|
|
|
|
|
2022-03-02 12:21:46 +01:00
|
|
|
A big thank you to Guy Sheffer (https://github.com/guysoft) for helping us
|
|
|
|
build a Raspberry Pi version!
|