Immich + PowerTools on Synology (via Portainer)

This repository provides stack .env and docker-compose.yml files to deploy Immich together with the Immich PowerTools service on a Synology NAS using Portainer.

About

• Immich
  A high-performance self-hosted photo and video backup solution.
  Docs: immich.app/docs

• Immich PowerTools
  A companion service that extends Immich with advanced features such as integrations and automation.

This project is not the official Immich or PowerTools repository.
It is a community example to help you configure the two services together on Synology NAS with Portainer. This runs also on the PG16 release with 0.4.3 and 0.2.0, keep in mind that this differs from the reccomendations from the developers

Why this repo?

• Synology users often run Docker containers via Portainer instead of raw CLI.
• Environment variables (stack.env) and compose files differ slightly depending on the NAS environment.
• This repo gives a ready-to-adapt baseline for your own setup.

Structure

• stack.env.example → editable environment variables (e.g. DB settings, ports, volumes).
• docker-compose.yml → services definition for both Immich and PowerTools.
• README.md → this documentation.

Prerequisites

• Synology NAS with Docker installed
• Portainer running on your NAS you can follow MariusHosting guide for this.
• Basic knowledge of editing .env files and Portainer stacks

Usage

1. Clone/download this repo to your NAS.
2. Make sure the following folders exist on your nas /yourvolume/docker/immich
3. Make sure that in the immich folder you have the following folders present redis, db, matplotlib, micro, cache, redis and upload
4. Copy stack.env. to stack.env and adjust values for your environment. or just copy and paste the contents in the advanced env editor in Portainer
5. Deploy the docker-compose.yml as a stack in Portainer.
6. Verify both services are running:
   • Immich: http://<NAS-IP>:8212 (default)
   • PowerTools: http://<NAS-IP>:8001 (default)

References

• Immich GitHub: github.com/immich-app/immich
• Immich Docs: immich.app/docs
• PowerTools GitHub: github.com/varun-raj/immich-power-tools
• PowerTools Site: immich-power-tools.featureos.app

---

⚠️ Disclaimer:
These files are provided as an example only.
Always review and adjust to your specific Synology environment before deploying.