Viseron

Self-hosted, local-only NVR and AI computer vision software

app

Alternative to: ring, nest, wyze

Repository Docs

About Versions (72)

Viseron is a self-hosted, local-only network video recorder that watches your IP cameras with AI computer vision, including object detection, motion detection and face recognition, without sending any footage to the cloud. It runs entirely in Docker and is configured through a built-in web interface, with optional hardware-accelerated decoding on Intel, NVIDIA, Raspberry Pi, Google Coral and Jetson Nano. Use it to keep an eye on your home, office or any other place you want to monitor.

Viseron Docker Compose example

Self-host Viseron on your own server, homelab, or VPS starting from this Docker Compose example. It runs Viseron in Docker containers using the official roflcoopter/viseron:latest image, with persistent volumes and automatic restarts preconfigured. Review the environment variables and adjust them to your setup, save the file as compose.yml (or docker-compose.yml), and start the stack with docker compose up -d.

services:
  viseron:
    image: roflcoopter/viseron:latest
    restart: unless-stopped
    # Shared memory used by the object/motion detectors for decoded video frames
    shm_size: "1024mb"
    volumes:
      - config:/config
      - segments:/segments
      - snapshots:/snapshots
      - thumbnails:/thumbnails
      - event_clips:/event_clips
      - timelapse:/timelapse
      # Use the host's timezone for logs and recording timestamps
      - /etc/localtime:/etc/localtime:ro
    environment:
      # User ID Viseron runs as / owns its files as — set to match your host user to avoid permission issues
      - PUID=1000
      # Group ID Viseron runs as / owns its files as
      - PGID=1000

volumes:
  config:
  segments:
  snapshots:
  thumbnails:
  event_clips:
  timelapse:

Prefer a managed setup? WinterFlow installs, configures, and updates Viseron for you using this same Docker Compose configuration.