photoprism/docker/examples/armv7
2021-12-10 23:02:40 +01:00
..
docker-compose.yml
README Docker: Update caption in ARMv7 and ARM64 READMEs 2021-12-10 23:02:40 +01:00

# Running PhotoPrism on ARMv7-based devices (32-bit)

You have to resort to alternative Docker images to run *PhotoPrism* and *MariaDB* on ARMv7-based devices
and those with a 32-bit operating system:

Stable Release     : photoprism/photoprism:armv7
Development Preview: photoprism/photoprism:armv7-preview
MariaDB            : linuxserver/mariadb:latest

Pay close attention to changed directory and environment variable names.

If your device meets the system requirements, mostly the same installation instructions as for regular Linux
servers apply otherwise: https://docs.photoprism.org/getting-started/docker-compose/

### System Requirements ###

- Your device should have at least 4 GB of memory. Running PhotoPrism on a server with less than 4 GB of swap space
  or setting a memory/swap limit can cause unexpected restarts, especially when the indexer temporarily needs more
  memory to process large files.
- If you see Docker errors related to "cgroups", it may help to add the following to `/boot/firmware/cmdline.txt`:
  ```
  cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1
  ```
- We recommend disabling Linux kernel security in your `docker-compose.yml`, especially if you do not have experience
  with the configuration:
  ```yaml
  photoprism:
    security_opt:
      - seccomp:unconfined
      - apparmor:unconfined
  ```
- If you install PhotoPrism on a public server outside your home network, please always run it behind a secure
  HTTPS reverse proxy such as Traefik, Caddy, or NGINX. Your files and passwords will otherwise be transmitted in
  clear text and can be intercepted by anyone, including your provider, hackers, and governments.

!!! Note
    Indexing large photo and video collections significantly benefits from fast, local SSD storage,
    and plenty of memory for caching. Especially the conversion of RAW images and the transcoding of
    videos are very demanding.

!!! Reducing System Load
    If you're running out of memory - or other system resources - while indexing, try reducing the
    [number of workers](https://docs.photoprism.org/getting-started/config-options/) by setting
    `PHOTOPRISM_WORKERS` to a reasonably small value in `docker-compose.yml` (depending on the performance of the server).
    As a measure of last resort, you may disable using TensorFlow for image classification and facial recognition.

### Getting Updates ###

If an old version is running on your device and doesn't update, you need to [explicitly pull](updates.md)
the latest image from [Docker Hub](https://hub.docker.com/r/photoprism/photoprism). Assuming that `:latest`
means new versions are automatically downloaded is a common mistake for users new to Docker.

### Credits ###

A big thank you to [Guy Sheffer](https://github.com/guysoft) for helping us [build](https://github.com/photoprism/photoprism/issues/109)
a Raspberry Pi version!