Privacy-First Security Camera System

Transform any Linux device into a powerful motion detection security camera. Self-hosted, open-source, and completely under your control.

Explore Features View on GitHub

What is OpenSentry?

A complete ecosystem for self-hosted security camera systems

OpenSentry - LMV

Live Motion Version

Turn any Linux device with a camera into a motion detection security system you control. All processing happens locally on your hardware - no cloud services required.

  • Real-time video streaming
  • Motion detection with overlays
  • Automatic snapshot capture
  • Works on Raspberry Pi & more
View Repository

OpenSentry Command

Central Management Hub

A lightweight, modern web UI for discovering and managing multiple OpenSentry devices across your network. One dashboard to control them all.

  • Automatic device discovery
  • Multi-device management
  • OAuth2/OIDC integration
  • REST API for automation
View Repository

Features

Everything you need for a complete security camera solution

Privacy First

All processing happens locally on your hardware. No cloud services, no data collection, complete control.

Motion Detection

Advanced motion detection using OpenCV with configurable sensitivity and real-time visual overlays.

Live Streaming

Real-time MJPEG video streaming to web browsers with support for multiple simultaneous viewers.

Automatic Snapshots

Capture snapshots automatically when motion is detected or manually via the web interface.

Device Discovery

Automatic network discovery via mDNS with fallback TCP/IP subnet scanning.

Flexible Authentication

Choose between local authentication or integrate with OAuth2/OIDC providers for enterprise SSO.

Technical Highlights

Low Resource Usage

Optimized for Raspberry Pi and ARM devices

Docker Ready

Complete Docker & Docker Compose support

REST API

Full REST API for automation and integration

Responsive Design

Mobile-friendly web interface

Hardware Acceleration

TurboJPEG support for fast encoding

Multi-Client

Handle multiple viewers simultaneously

Comprehensive Logging

Ring buffer in-memory logs for debugging

MIT Licensed

Open source and free to use

Documentation

Get started with OpenSentry in minutes

Quick Start

OpenSentry - LMV

Run on your camera device (Raspberry Pi, etc.)

Using Docker Compose (Recommended)
git clone https://github.com/Sbussiso/OpenSentry-LVM.git
cd OpenSentry-LVM
docker compose up -d
From Source
git clone https://github.com/Sbussiso/OpenSentry-LVM.git
cd OpenSentry-LVM
uv run server.py

Access the web interface at http://<device-ip>:5000

OpenSentry Command

Run on your central management device

Using Docker Compose (Recommended)
git clone https://github.com/Sbussiso/OpenSentry-Command.git
cd OpenSentry-Command
docker compose up -d
From Source
git clone https://github.com/Sbussiso/OpenSentry-Command.git
cd OpenSentry-Command
uv run main.py

Access the dashboard at http://<device-ip>:5000

Hardware Requirements

Device Performance Recommended Use
Raspberry Pi Zero 2 W Low FPS Basic monitoring, low traffic areas
Raspberry Pi 3 Moderate Standard home security
Raspberry Pi 4/5 Good Smooth streaming, multiple clients
Intel NUC / Desktop Excellent High-performance, multiple cameras
Camera Requirements: Any V4L2-compatible camera (USB webcams, Raspberry Pi Camera Module, etc.)

Configuration

Motion Detection Settings

Adjust sensitivity via the web settings page or config.json:

  • Sensitivity: Detection threshold (lower = more sensitive)
  • Min Area: Minimum motion area to trigger detection
  • Cooldown: Time between automatic snapshots
Authentication Modes

Choose your authentication method:

  • Local: Username/password (default: admin/admin)
  • OAuth2/OIDC: Integrate with Keycloak, Auth0, Okta, Google, etc.
  • None: Public access (not recommended for production)

Use Cases

Home Security

Monitor entrances, windows, and perimeter areas with motion-triggered alerts

Wildlife Observation

Capture wildlife activity with automatic motion-triggered snapshots

Small Office

Monitor office spaces with centralized management and OAuth2 integration

Perimeter Monitoring

Deploy multiple cameras around property boundaries with unified dashboard

Parking/Garage

Track vehicle activity and detect unexpected movement in parking areas

Smart Home Integration

Integrate with home automation systems via REST API

Community & Support

Join the OpenSentry community

OpenSentry - LMV

Motion detection camera system

View Repository
Report Issues Pull Requests

OpenSentry Command

Central management hub

View Repository
Report Issues Pull Requests

Contributing

OpenSentry is open source and welcomes contributions! Whether you're fixing bugs, adding features, improving documentation, or sharing feedback, your input is valuable.

Fork OpenSentry LMV Fork OpenSentry Command

Technology Stack

Python 3.12+

Flask

OpenCV

Docker

MJPEG Streaming

mDNS/Zeroconf

OAuth2/OIDC

REST API