diff --git a/docker/examples/arm64/README b/docker/examples/arm64/README
index ee62bc14a..29bd093a7 100644
--- a/docker/examples/arm64/README
+++ b/docker/examples/arm64/README
@@ -1,5 +1,5 @@
-PhotoPrism for Raspberry Pi (64bit)
-===================================
+PhotoPrism for the Raspberry Pi and other ARM-based devices
+===========================================================
 
 Our latest release comes as a single multi-arch image for AMD64, ARM64, and ARMv7.
 If your device meets the system requirements, the same installation instructions
@@ -55,10 +55,10 @@ This may be necessary after upgrading, especially to new major versions.
 
 ## System Requirements ##
 
-It's important to boot your Raspberry Pi 3 / 4 with the parameter "arm_64bit=1" in config.txt
-in order to use our Docker image.
+It's important that you boot your Raspberry Pi 3 / 4 with the parameter "arm_64bit=1"
+in config.txt to use our ARM64 image.
 
-Alternatively, you may run the image on UbuntuDockerPi (https://github.com/guysoft/UbuntuDockerPi).
+Alternatively, you may run it on UbuntuDockerPi (https://github.com/guysoft/UbuntuDockerPi).
 It's a 64bit Ubuntu Server with Docker pre-installed.
 
 Your device should have at least 4 GB of memory. Also make sure it has at least 4 GB of swap
diff --git a/docker/examples/arm64/docker-compose.yml b/docker/examples/arm64/docker-compose.yml
index da97cbe06..3ba3d02ce 100644
--- a/docker/examples/arm64/docker-compose.yml
+++ b/docker/examples/arm64/docker-compose.yml
@@ -1,6 +1,9 @@
 version: '3.5'
 
-# Example Docker Compose config file for PhotoPrism (Raspberry Pi / ARM64)
+# Example Docker Compose config file for PhotoPrism (Raspberry Pi and other ARM-based devices)
+#
+# ATTENTION: It's important that you boot your Raspberry Pi 3 / 4 with the parameter "arm_64bit=1"
+# in config.txt to use our ARM64 image.
 #
 # Documentation : https://docs.photoprism.org/getting-started/raspberry-pi/
 # Docker Hub URL: https://hub.docker.com/r/photoprism/photoprism/
@@ -33,8 +36,11 @@ version: '3.5'
 
 services:
   photoprism:
+    # Our stable version and development preview now come as a single multi-arch image for AMD64, ARM64, and ARMv7.
     # Use photoprism/photoprism:preview instead for testing preview builds:
     image: photoprism/photoprism:latest
+    # Owners of ARMv7-based devices may have to explicitly specify the image architecture:
+    # platform: "linux/arm/v7"
     depends_on:
       - mariadb
     # Only enable automatic restarts once your installation is properly
@@ -99,6 +105,9 @@ services:
       # Permanent storage for settings, index & sidecar files (DON'T REMOVE):
       - "./storage:/photoprism/storage"
 
+  # ATTENTION: Owners of ARMv7-based devices have to revert to an alternative image if they want to use MariaDB.
+  # The official image is available for AMD64 and ARM64 only. Pay close attention to changed directory and
+  # environment variable names.
   mariadb:
     restart: unless-stopped
     image: arm64v8/mariadb:10.5