Install on Docker (Windows)

Run CrossWatch on Windows using Docker Desktop (WSL2 backend).

Use Docker Desktop with the WSL2 backend.

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

• Docker Desktop.

• A local folder for CrossWatch state (persisted on your PC).

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

Option A: Docker Compose (recommended)

1. Create a folder for state:

   • Example: C:\crosswatch\config

2. Create docker-compose.yml next to it.

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

Start it (PowerShell):

docker compose up -d

Open http://localhost:8787.

Option B: Docker run

docker run -d `
  --name crosswatch `
  -p 8787:8787 `
  -v C:\crosswatch\config:/config `
  -e TZ=UTC `
  --restart unless-stopped `
  ghcr.io/cenodude/crosswatch:latest

Updating

Docker Compose

docker compose pull
docker compose up -d

Docker

Common Windows gotchas

• If the bind mount fails, make sure the drive is shared in Docker Desktop.

• Avoid OneDrive-synced folders for /config.

Next steps

• Continue with First-time setup.

• See the full reference in Docker setup.