Install on QNAP QTS

Deploy CrossWatch on QNAP using Container Station.

On QNAP, you’ll typically use Container Station.

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

• QTS with Container Station installed.

• A shared folder to persist CrossWatch state.

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

Install (Container Station)

1. Open Container Station.

2. Create a new container.

3. Image: ghcr.io/cenodude/crosswatch:latest.

4. Network mode: Bridge.

5. Port mapping:

   • Host 8787 → Container 8787

6. Volume mapping:

   • Host: your shared folder (example: /share/Container/crosswatch/config)

   • Container: /config

7. Environment:

   • TZ=UTC

8. Restart policy: unless-stopped (or “Always”).

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

Updating

• Pull the latest image in Container Station.

• Recreate/restart the container.

Permissions for /config

If the container can’t write:

• Give the mapped share write permission.

• Or set APP_UID/APP_GID to match the share owner.

Next steps

• Continue with First-time setup.