PatchMon

PatchMon is an enterprise-grade platform that gives operations teams a single pane of glass to monitor, patch and secure their Linux fleet, with FreeBSD and Windows agent support.

Automatically checked · GitHub checked 2026-11-12

PatchMon

Overview

PatchMon

Enterprise-grade Linux patch & server management platform

Website Cloud Discord GitHub Feedback Roadmap Documentation

Latest Release Stars License AI-DECLARATION: pair


What is PatchMon?

PatchMon is an enterprise-grade platform that gives operations teams a single pane of glass to monitor, patch and secure their Linux fleet, with FreeBSD and Windows agent support.

A lightweight agent communicates outbound-only to the PatchMon server on your schedule - no inbound ports required on monitored hosts - delivering real-time visibility into package health, compliance posture and system status across environments of any scale.

Dashboard Screenshot


Why PatchMon?

  • Outbound-only agents - no inbound firewall changes, no SSH or WinRM exposure, no VPN required.
  • Single binary, bundled UI - one Go binary with the React frontend embedded. One container, no Node runtime at deploy time.
  • Open source, with a managed cloud - AGPL v3 licensed, free to self-host. Production hosting available at patchmon.net/cloud.
  • Multi-OS by design - Linux (apt, dnf, yum, apk, pacman), FreeBSD (pkg) and Windows, handled by the same agent and control plane.

Quick Start

Docker is the fastest way to try PatchMon:

mkdir patchmon && cd patchmon
bash -c "$(curl -fsSL https://raw.githubusercontent.com/PatchMon/PatchMon/refs/heads/main/docker/setup-env.sh)"
docker compose up -d

Open http://localhost:3000, create an admin user, add a host in the UI and copy the generated install command onto the target server.

Full deployment options (Docker manual, Proxmox LXC, PatchMon Cloud) are in the Deployment section.


Features at a Glance

Patch Management

The core of PatchMon - orchestrate updates across your fleet with validation, approval and live visibility.

CapabilityWhat It Does
Dry-Run ValidationPreview the exact package transaction on a host before anything touches production. Every run captures the full plan so you know what would change.
Approve & ExecuteOne-click approval turns a validated dry-run into a real patch run, with a per-host audit trail of who approved what and when.
Scheduled PatchingPatch policies decide when updates apply - immediate, maintenance window or delayed rollout. Approve now, execute later.
Live Patch StreamingWatch patch execution in real time from the browser. Agent stdout/stderr is streamed over WebSocket, with the ability to stop a run mid-flight.
Selective PatchingTarget specific packages, security-only updates or a full upgrade. Works across apt, dnf, yum, apk, pacman and FreeBSD pkg.
Patch History & AuditFull searchable history of every run - exit code, duration, packages touched, approver and host.

Patching Screenshot

Visibility & Inventory

CapabilityWhat It Does
Personalised DashboardPer-user, drag-and-reorder overview cards showing fleet health, outdated packages, host status and patching activity at a glance.
Host InventoryBrowse every enrolled server with OS, uptime, kernel, last check-in and group membership.
Package InventoryView every installed package across your fleet, filter to outdated or vulnerable ones, and see exactly which hosts need attention.
Repository TrackingEvery APT / YUM / DNF / APK / pacman repository configured on each host, in one place.
Docker MonitoringAutomatic discovery of containers, images, volumes and networks with real-time status pushed over WebSocket.

Security & Compliance

CapabilityWhat It Does
Compliance ScanningRun OpenSCAP CIS Benchmarks and Docker Bench for Security. Track compliance scores over time with rule-level results and remediation guidance.
AlertingHost-down, pending server updates and agent-update alerts. Filter by severity, type and status; assign to team members.
Outbound-Only AgentNo inbound ports on monitored hosts. Agent initiates all traffic, with IP allow-lists for enrolment tokens and rate limiting on every endpoint.
RBACMulti-user accounts with fully customisable roles and granular permissions - every team member sees only what they need.
OIDC Single Sign-OnAuthenticate with Authentik, Keycloak, Okta or any OIDC provider. Supports auto user provisioning, group-to-role mapping and SSO-only enforcement.

Reporting & Alerts Screenshot

Notification Routing Screenshot

Access & Operations

CapabilityWhat It Does
Web SSH TerminalBrowser-based SSH to any host directly from the UI. Direct or proxy mode (route through the agent, no SSH port exposure).
AI Terminal AssistantBuilt-in AI chat panel inside the SSH terminal for command suggestions, error diagnosis and context-aware help. Works with OpenRouter, Anthropic, OpenAI or Google Gemini.
Branding & ThemingUpload custom logos and favicon, choose colour themes and toggle light / dark mode per user.

AI Terminal Assistant Screenshot

Platform

CapabilityWhat It Does
Integrations33+ integrations including Proxmox LXC auto-enrolment, getHomepage, Ansible and more.
REST APIFull /api/v1 with JWT authentication and interactive Swagger / OpenAPI docs at /api-docs.

Deployment Options

PatchMon Cloud

14-day trial at patchmon.net/pricing

Fully managed PatchMon hosting with zero infrastructure overhead. We handle provisioning, updates, backups and scaling so you can focus on your fleet instead of the tooling behind it.

Self-Hosted - Docker (Officially supported)

Docker is the preferred and supported self-hosted deployment. We use hardened images for security.

Automated setup from an empty directory. The setup script downloads docker-compose.yml and env.example, generates all required secrets, and walks you through URL and CORS_ORIGIN configuration interactively:

mkdir patchmon && cd patchmon
bash -c "$(curl -fsSL https://raw.githubusercontent.com/PatchMon/PatchMon/refs/heads/main/docker/setup-env.sh)"
docker compose up -d

Access the application at the URL you configured (default: http://localhost:3000).

Manual Docker setup: see Installing PatchMon Server on Docker.

Self-Hosted - Proxmox LXC

One-command LXC deployment via the Proxmox VE Helper-Scripts community script:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/patchmon.sh)"

Enrolling Hosts

Once the server is running:

  1. Log in to the UI and add a host under Hosts.
  2. PatchMon generates a one-line install command with a per-host API key.
  3. Paste the command on the target server (requires root/sudo) and the agent enrols itself.

Supported agent platforms: Linux (amd64, 386, arm64, arm), FreeBSD (amd64, 386, arm64, arm), Windows (amd64, 386, arm64).

Minimum Server Specs

ResourceRequirement
CPU2 vCPU
RAM2 GB
Disk15 GB

Architecture

ComponentTechnology
BackendGo, sqlc, chi router
FrontendReact + Vite, embedded in the patchmon-server binary
DatabasePostgreSQL 17
QueueRedis 7 (Asynq)
AgentGo binary - Linux, FreeBSD, Windows
flowchart LR
    A[Browser / Admin UI] -- HTTPS --> B[Your Reverse Proxy]
    B -- HTTP --> C[Backend - Go Binary]
    C -- TCP --> D[(PostgreSQL)]
    C -- TCP --> R[(Asynq + Redis)]
    E[Agents on your servers] -- HTTPS + WSS --> C

Agents initiate all communication. HTTPS carries reports and config; WSS (WebSocket over TLS) carries real-time events such as live patch streaming and Docker status. Ensure that Websockets is supported by your proxy when passing the traffic to PatchMon container :3000 or whichever port you decide to use.


Documentation

Full documentation at patchmon.net/docs.

TopicLink
Installing on DockerDocker install guide
Environment variablesEnv vars reference
Integration APIIntegration API docs
Proxmox LXC auto-enrolmentProxmox guide
getHomepage dashboard cardgetHomepage integration
Metrics collectionMetrics info

Support

Community

Professional & Enterprise


Contributing

We welcome contributions from the community. See CONTRIBUTING.md for the full guide: code style, commit conventions, running tests, documentation workflow and the PR process.

Quick summary:

  • Follow existing patterns and the Biome / golangci-lint configurations.
  • Use conventional commit messages (feat:, fix:, docs:, etc.).
  • Add tests for new features and ensure the full suite passes.
  • Update documentation alongside code changes.

Good first issues are labelled in the issue tracker.

Not sure where something goes? Bugs belong in GitHub Issues, feature ideas in the feedback portal, and questions in Discussions. The help centre explains each in more detail.

If you plan to build a feature, please get the request accepted on the feedback portal first. AI-assisted contributions are welcome but disclosure is required - see AI-Assisted Contributions and our AI Declaration.


Roadmap

Track upcoming features and vote on what gets built next at feedback.patchmon.net/roadmap.

Requests we have accepted appear on the roadmap and move through Planned, In Progress and Completed as they ship. Voting is open to everyone and you are notified when something you voted for is released. See How a feature request gets built for the full process.


PatchMon PRO - Enterprise & Vendor Support

PatchMon is trusted by teams managing production infrastructure worldwide. We offer global vendor support and enterprise solutions tailored to your organisation's requirements.

OfferingDetails
PatchMon CloudFully managed hosting - we handle infrastructure, updates, backups and scaling for you.
Global Vendor SupportDedicated technical support available worldwide with SLA-backed response times.
Custom IntegrationsBespoke API endpoints, third-party connectors and tailored dashboards built to your specification.
On-Premises / Air-GappedDeploy in your own data centre or isolated environment with full support.
White-Label SolutionsBrand PatchMon as your own with custom logos, domains and theming, plus multi-context deployment options.
Training & OnboardingComprehensive team training and onboarding programmes for your organisation.
ConsultingArchitecture review, deployment planning and migration assistance from the team that builds PatchMon.

Contact us at [email protected] for enterprise and vendor support enquiries.


License

AGPL v3 - see LICENSE for details.


Made with ❤️ by the PatchMon Team

This project represents hundreds of hours of development work. If PatchMon has saved you time or helped secure your infrastructure, a coffee would genuinely mean the world.

Buy Me A Coffee

⭐ If you find PatchMon useful, please star this repo - it helps others discover the project!

Website Cloud Discord GitHub Feedback Documentation