Running PhotoPrism on a Synology NAS

Visit the Synology Knowledge Base to learn what kind of CPU and how much memory your device has. We recommend hosting PhotoPrism on a 64-bit system with at least 2 cores and 3 GB of physical memory. High-resolution panoramic images may require additional swap space and/or physical memory above the recommended minimum.

RAW image conversion and TensorFlow are disabled on devices with 1 GB or less memory. You will have to resort to 32-bit Docker images to run PhotoPrism and MariaDB on ARMv7-based entry-level devices like the Synology DS218j.

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. We take no responsibility for instability or performance problems if your device does not meet the requirements.

Setup using Docker

We recommend following these instructions to install PhotoPrism on your Synology NAS:

https://www.wundertech.net/how-to-setup-photoprism-on-a-synology-nas

Will my device be fast enough?

This largely depends on your expectations and the number of files you have. Most users report that PhotoPrism runs well on their Synology NAS. However, you should keep in mind:

• initial indexing may take longer than on standard desktop computers
• the hardware has no video transcoding support and software transcoding is generally slow

Troubleshooting

If your device 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
• Make sure your device has at least 4 GB of swap space so that indexing doesn't cause restarts when memory usage spikes; RAW image conversion and video transcoding are especially demanding
• 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.

You are welcome to ask for help in our community chat. Sponsors receive direct technical support via email. Before submitting a support request, try to determine the cause of your problem.