Docker: Update ARMv7 and ARM64 README files
This commit is contained in:
Michael Mayer
parent
a6436b5988
commit
754e11a9af
2 changed files with 70 additions and 63 deletions
|
|
@ -1,7 +1,7 @@
|
|||
>> Running PhotoPrism on ARM64-based devices (64-bit) <<
|
||||
>> Running PhotoPrism on ARM64-based devices (64-bit) <<
|
||||
|
||||
Our stable version and development preview have been built into a single multi-arch Docker
|
||||
image for 64-bit AMD, Intel, and ARM processors (Apple Silicon, Raspberry Pi 4):
|
||||
Our stable version and development preview have been built into a single multi-arch
|
||||
Docker image for 64-bit AMD, Intel, and ARM processors (Apple Silicon, Raspberry Pi 4):
|
||||
|
||||
Stable Release : photoprism/photoprism:latest
|
||||
Development Preview: photoprism/photoprism:preview
|
||||
|
|
@ -18,56 +18,62 @@ as for regular Linux servers apply:
|
|||
|
||||
https://docs.photoprism.app/getting-started/docker-compose/
|
||||
|
||||
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.
|
||||
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.
|
||||
|
||||
Note that Raspberry Pi OS (Raspbian) is a 32-bit user-space Linux with a 64-bit kernel to
|
||||
remain compatible with older Raspberry software. This requires special configuration to run
|
||||
modern 64-bit applications and Docker images (see below).
|
||||
Note that Raspberry Pi OS (Raspbian) is a 32-bit user-space Linux with a 64-bit
|
||||
kernel to remain compatible with older Raspberry software. This requires special
|
||||
configuration to run modern 64-bit applications and Docker images (see below).
|
||||
|
||||
If you do not have legacy software, we recommend choosing a standard 64-bit Linux distribution
|
||||
as it requires less experience:
|
||||
If you do not have legacy software, we recommend choosing a standard 64-bit Linux
|
||||
distribution as it requires less experience:
|
||||
|
||||
- Raspberry Pi Debian: https://raspi.debian.net/
|
||||
- Ubuntu for Raspberry Pi: https://ubuntu.com/raspberry-pi
|
||||
- UbuntuDockerPi: https://github.com/guysoft/UbuntuDockerPi (Ubuntu incl. Docker pre-configured)
|
||||
> Raspberry Pi Debian: https://raspi.debian.net/
|
||||
> Ubuntu for Raspberry Pi: https://ubuntu.com/raspberry-pi
|
||||
> UbuntuDockerPi: https://github.com/guysoft/UbuntuDockerPi (Ubuntu incl. Docker pre-configured)
|
||||
|
||||
Other distributions that target the same use case as Raspbian, such as CoreELEC, may have
|
||||
the same problems and should also not be used to run modern server applications.
|
||||
Other distributions that target the same use case as Raspbian, such as CoreELEC,
|
||||
may have the same problems and should also not be used to run modern server
|
||||
applications.
|
||||
|
||||
### Raspberry Pi OS ###
|
||||
|
||||
To ensure compatibility with 64-bit Docker images, your Raspberry Pi 3 / 4 must boot with
|
||||
the "arm_64bit=1" flag in its "config.txt" file:
|
||||
To ensure compatibility with 64-bit Docker images, your Raspberry Pi 3 / 4 must
|
||||
boot with the "arm_64bit=1" flag in its "config.txt" file:
|
||||
|
||||
https://www.raspberrypi.org/documentation/installation/installing-images/README.md
|
||||
|
||||
An "exec format" error will occur otherwise.
|
||||
|
||||
Try explicitly pulling the ARM64 version if you've booted your device with the "arm_64bit=1"
|
||||
flag and you see the "no matching manifest" error on Raspberry Pi OS (Raspbian):
|
||||
Try explicitly pulling the ARM64 version if you've booted your device with the
|
||||
"arm_64bit=1" flag and you see the "no matching manifest" error on
|
||||
Raspberry Pi OS (Raspbian):
|
||||
|
||||
docker pull --platform=arm64 photoprism/photoprism:latest
|
||||
|
||||
It may also help to set the DOCKER_DEFAULT_PLATFORM environment variable to "linux/arm64".
|
||||
It may also help to set the DOCKER_DEFAULT_PLATFORM environment variable to
|
||||
"linux/arm64".
|
||||
|
||||
### System Requirements ###
|
||||
|
||||
- Your device should have at least 3 GB of physical memory and a 64-bit operating system
|
||||
- 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:
|
||||
- Your device should have at least 3 GB of physical memory and a 64-bit
|
||||
operating system
|
||||
- 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:
|
||||
|
|
|
|||
|
|
@ -1,19 +1,18 @@
|
|||
>> Running PhotoPrism on ARMv7-based devices (32-bit) <<
|
||||
>> 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
|
||||
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.
|
||||
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:
|
||||
|
|
@ -22,10 +21,10 @@ instructions as for regular Linux servers apply:
|
|||
|
||||
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.
|
||||
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 ###
|
||||
|
||||
|
|
@ -33,25 +32,26 @@ the bottom of this README file.
|
|||
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
|
||||
- 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:
|
||||
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:
|
||||
- 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 ###
|
||||
|
|
@ -68,10 +68,11 @@ system resources are running low:
|
|||
- 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
|
||||
- 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:
|
||||
Other issues? Our troubleshooting checklists help you quickly diagnose and
|
||||
solve them:
|
||||
|
||||
https://docs.photoprism.app/getting-started/troubleshooting/
|
||||
|
||||
|
|
@ -88,8 +89,8 @@ from Docker Hub and restart your instance in the background:
|
|||
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.
|
||||
Note that running an image with ":latest" tag does not cause Docker to
|
||||
automatically download new images.
|
||||
|
||||
### Credits ###
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue