How to Install Whisparr on a Synology NAS

Install Whisparr on Synology with Container Manager — a practical, beginner-friendly walkthrough.

How to Install Whisparr on a Synology NAS — feature illustration

Synology's Container Manager (the successor to the old Docker package) makes Whisparr a comfortable fit on DSM. This walkthrough uses a Compose project, which is easier to maintain than clicking through the container wizard and gives you a config you can re-apply after DSM updates.

Before you start

  • Your Synology model must support Container Manager (most Plus-series and many mid-range models do — check your model's package center).
  • Install Container Manager from Package Center.
  • Optionally enable SSH (Control Panel → Terminal & SNMP) for one quick command below.

Step 1 — Create the shared folders

In Control Panel → Shared Folder, create (or reuse) a structure like:

/volume1/docker/whisparr     ← config
/volume1/data/downloads      ← download client output
/volume1/data/media          ← organized library

As with every platform, downloads and media should share the data parent so imports are instant hardlinks rather than slow copies across shares.

Step 2 — Find your PUID and PGID

Connect over SSH and run id yourusername. Note the uid and gid values — they map the container to a real DSM user so file permissions work. Give that user read/write permission on both shared folders above.

Step 3 — Create the Compose project

In Container Manager, open Project → Create, choose the /volume1/docker/whisparr folder as the path, and paste:

services:
  whisparr:
    image: <your-chosen-whisparr-image>
    container_name: whisparr
    environment:
      - PUID=1026
      - PGID=100
      - TZ=Asia/Karachi
    ports:
      - "6969:6969"
    volumes:
      - /volume1/docker/whisparr:/config
      - /volume1/data:/data
    restart: unless-stopped

Replace the PUID/PGID with your values from step 2 (1026/100 is only a common Synology default). Click through to build and start the project.

Step 4 — First run and verification

Browse to http://synology-ip:6969. Enable authentication, set /data/media as the root folder, connect indexers (directly or via Prowlarr running on the same NAS), and point your download client at a folder inside /data/downloads. Send one test item through and confirm it lands renamed in the library.

Synology-specific notes

  • Port conflicts: DSM itself uses many ports. If 6969 is taken on your unit, change only the left-hand side of the port mapping.
  • Updates: in Container Manager, pull the newer image and rebuild the project — the config folder preserves everything. The workflow matches our general compose guide.
  • Backups: add /volume1/docker/whisparr to Hyper Backup. The config folder is small and restoring it fully restores your setup.

Download Now

Related guides