Pellicle Help

QNAP NAS Setup

This guide covers deploying the pellicle-watcher container using QNAP's Container Station app. Make sure you have completed steps 1 and 2 (generating a token and creating the configuration file) before continuing.

Upload the Configuration File

First, create a folder for the project and upload your config.yml:

  1. Open File Station.
  2. Navigate to the Container shared folder (created automatically by Container Station).
  3. Create a new folder called pellicle-watcher.
  4. Upload your config.yml file into this folder.

Create the Application

  1. Open Container Station from the QTS main menu.
  2. Click the Create tab, then select Create Application.
  3. Enter an application name (e.g. pellicle-watcher).
  4. Paste the following into the YAML editor:
services:
pellicle-watcher:
image: robotmay/pellicle-watcher:0.1.14
network_mode: host
restart: unless-stopped
volumes:
- /share/Photography:/data/Photography:ro
- /share/Container/pellicle-watcher/config.yml:/etc/pellicle-watcher/config.yml:ro
- /share/Container/pellicle-watcher/tls:/etc/pellicle-watcher/tls
  1. Click Validate YAML to check the formatting is correct.
  2. Click Create to deploy the container.

Note: Adjust the volume path (/share/Photography) to match where your photos are stored. QNAP shared folders are typically under /share/. Unlike Synology, relative paths (like ./config.yml) may not resolve as expected, so use full paths for all volume mounts.

Note: If you edit the docker-compose.yml file outside of Container Station (e.g. via SSH), it will be marked as externally modified and can only be edited externally from that point on. Make all changes through the Container Station UI to avoid this.

Verify it's Running

In Container Station, go to the Overview or Applications tab. Your application should show as running. Click on it to view the container logs and confirm the watcher is listening on the configured port.

Now continue with step 5: Configure Pellicle.