Skip to content

Overseer Documentation

Overseer is a push-based monitoring system for servers, networks and services. Self-hosted, multi-tenant capable, made in South Tyrol.

Quick start

Want to install Overseer on your own server? Jump to the Installation guide.

What Overseer does

  • Push-based monitoring — no inbound ports, no firewall pain
  • Two monitoring modes — Collector (for remote checks via SNMP/SSH/Ping/HTTP) and Agent (Go binary running directly on the target machine)
  • Auto-discovery — network scans detect new hosts automatically
  • Alerting with dependencies — inhibition suppresses cascade alerts when the parent host is down
  • Custom dashboards with 16 widget types
  • Wiki & AI assistant — built-in knowledge base, optionally backed by a local or cloud LLM
  • Mobile app for Android with push notifications
  • Status pages for external communication
  • SSO via OIDC, SAML and LDAP
  • Multi-tenant for MSPs and larger environments

Architecture

[Collector VMs] ──HTTPS POST──┐ ├──> [Receiver] → [Redis] → [Worker] → [PostgreSQL + TimescaleDB] [Agents (Go)] ──HTTPS POST──┘ │ [REST API] ←→ [React Frontend]

Everything speaks outbound HTTPS 443 only. No VPN, no open ports on the customer side.

Stack

Component Technology
API, Worker, Receiver Python 3.12 + FastAPI
Collector, Agent Go 1.22+
Frontend React 18 + TypeScript + Vite
Database PostgreSQL 17 + TimescaleDB
Queue Redis 8 Streams
Deployment Docker Compose

Help & contact