Install on Synology DSM

Deploy CrossWatch on Synology using Container Manager (or Docker).

Synology runs CrossWatch like any other Docker app.

We do not provide support for installing or troubleshooting container runtimes.

These pages assume Docker (or your NAS container manager) is already installed and working.

If Docker itself is broken, use your platform docs first.

The install guides are provided for reference only.

What you need

• DSM 7 with Container Manager (or the legacy Docker package).

• A shared folder to persist CrossWatch state.

Do not run without the /config volume. You will lose state when the container is recreated.

Recommended: Container Manager “Project” (Compose)

1. Create a folder in File Station.

   • Example: docker/crosswatch/config

2. In Container Manager → Project → Create.

3. Paste this compose file.

4. Set the volume host path to your folder.

services:
  crosswatch:
    image: ghcr.io/cenodude/crosswatch:latest
    container_name: crosswatch
    ports:
      - "8787:8787"
    environment:
      - TZ=UTC
    volumes:
      - /volume1/docker/crosswatch/config:/config
    restart: unless-stopped

Open http://<synology-ip>:8787.

Permissions for /config

If CrossWatch can’t write to /config, you have two options:

• Give the folder write access for the account/container runtime.

• Or set user IDs explicitly:

  • Add environment variables APP_UID and APP_GID to match the folder owner.

If you use SSH, you can find your UID/GID with:

id <your-dsm-username>

Updating

• In Container Manager, update the image, then Recreate / Update the project.

Next steps

• Continue with First-time setup.

• For reverse proxy, see Reverse proxies.