Container installation

Install CrossWatch as a Docker container on Portainer, Linux/Windows, and common NAS platforms.

CrossWatch runs as a single Docker container.

Pick the install path that matches your platform.

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.

Key defaults

• UI port: 8787

• Persisted state: mount a host folder to /config

• Recommended env var: TZ

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

Install guides

• Install with Portainer

• Install on Docker (Linux)

• Install on Docker (Windows)

NAS platforms

• Install on Synology DSM

• Install on Unraid

• Install on QNAP QTS

• Install on OpenMediaVault

• Install on Asustor NAS

Prefer the generic guide?

Use Docker setup if you already know your platform’s Docker UI.

Summary

Run CrossWatch as a single container.

Expose port 8787 and mount a host folder to /config.

Set TZ so logs and timestamps match your timezone.

Next steps

• Do the initial in-app configuration: First-time setup

• If you want HTTPS or a custom domain: Reverse proxies or HTTPS/TLS

• If the UI doesn’t load or state resets: Docker setup