Run the hub with Docker or on a NAS

The hub ships as a Docker image, so it runs on most NAS systems and servers.

Start it

From the Unicam folder, with Docker Compose:

docker compose up -d

Then open http://<your-nas-ip>:7700 and pair with the code from the log:

docker compose logs unicam-hub

Why host networking

The compose file uses host networking. That lets the hub discover cameras on your network (ONVIF uses multicast, which doesn’t cross Docker’s default bridge) and serve live video over WebRTC directly. The hub uses port 7700 for the app and API and 8555 (TCP and UDP) for live video.

Where data goes

• ./unicam-data holds the hub’s database, keys and local footage. Back this folder up; it contains your encryption keys.
• To record onto a NAS share or USB disk, mount it into the container (the compose file has a commented example), then add that path in Storage → Folder / NAS / USB.

The container runs as an unprivileged user.

Synology, QNAP, Unraid, TrueNAS

Use your NAS’s Docker or Container Manager with the same compose file, keeping host network mode. Map the data folder to a share you back up.

Home Assistant

Unicam’s hub is also available as a Home Assistant add-on. Add the Unicam add-on repository in Home Assistant, install it, and open its web UI to pair.

Don’t expose it to the internet

Never port-forward 7700 or your cameras’ RTSP ports on your router. Use Tailscale for access away from home. See Remote access.