PatchMon: Enterprise-grade Linux patch & server management platform
PatchMon: Enterprise-grade Linux patch & server management platform
PatchMon is a next-generation operations platform designed to give IT and security teams a single pane of glass for monitoring, patching, and securing a diverse fleet of Linux servers, with support for FreeBSD and Windows agents as well. Built to scale from a handful of hosts to thousands, PatchMon emphasizes outbound-only communication, a lightweight agent footprint, and a modern control plane that can live on-premises or in the cloud. This blog post walks you through what PatchMon is, why it matters, how to get started, and what you can expect from its feature set, deployment models, and roadmap.
What is PatchMon?
At its core, PatchMon is an enterprise-grade platform that unifies patch management, visibility, security, and operations into a single console. The agent is designed to be outbound-only, initiating connections to the PatchMon server on a schedule you control. That design eliminates the need to open inbound ports, SSH, WinRM, or VPN tunnels to every monitored host. In practice, this translates to real-time visibility into package health, compliance posture, and system status across environments of any scale.
PatchMon supports Linux distributions using apt, dnf, yum, apk, and pacman ecosystems, FreeBSD via pkg, and Windows. A single agent handles all of these platforms while communicating with a unified control plane, simplifying onboarding and standardizing patch workflows across heterogeneous fleets. The UI is embedded in a small footprint Go binary, delivering a streamlined deployment model with minimal runtime dependencies.
To illustrate its focus, PatchMon ships with a polished dashboard that provides fleet health insights, up-to-date patching status, and live feedback during operations. The goal is to give operations teams the confidence to validate, approve, and execute patches with full traceability and minimal disruption to production.
Why PatchMon?
PatchMon is built around a few core principles that address common challenges in fleet management:
- Outbound-only agents: No inbound firewall changes, no SSH exposure, and no VPN requirements. Agents initiate communication to the PatchMon server, preserving security while delivering timely data.
- A single binary with a bundled UI: The control plane reduces complexity with one Go binary and a React frontend embedded, eliminating the need for a separate Node runtime during deployment.
- Open source with managed cloud options: The AGPL v3 license makes PatchMon free to self-host, while PatchMon Cloud offers scalable, production-grade hosting with provisioning, updates, backups, and auto-scaling.
- True multi-OS support by design: A unified agent handles Linux, FreeBSD, and Windows, simplifying cross-platform patching and compliance workflows.
- Transparent patch orchestration: Dry-run validation, per-host audit trails, scheduled patching, and live streaming of patch execution enable precise changes and measurable outcomes.
The combination of zero inbound exposure, a unified agent, and an intuitive interface makes PatchMon appealing for teams looking to reduce attack surfaces, improve patch compliance, and gain real-time visibility into fleet health.
Quick Start
Getting started with PatchMon is straightforward and fast. The fastest path is to use Docker to spin up a local instance and see the patching workflow in action.
- Create a working directory and initialize PatchMon using the official setup script.
- Start the Docker Compose stack and wait for the UI to become available.
- Open the UI at the configured URL, create an admin user, add a host, and generate the install command for the target server.
- Enroll the host by placing the install command on the target server (root or sudo privileges required).
While Docker provides a quick path for evaluation, PatchMon also ships with self-hosted options for Proxmox LXC or PatchMon Cloud for production deployments.
Features at a Glance
PatchMon brings together patch management, inventory, security, and operational tooling in a coherent, enterprise-friendly package. Below is a detailed tour of the major capabilities, organized by functional area.
Patch Management
Patch management is the heart of PatchMon—the orchestrator that coordinates updates across your fleet while ensuring safety, compliance, and traceability.
Dry-Run Validation
Before applying any updates, PatchMon simulates the patch transaction on each host and presents a full plan of what would change.
The dry-run capture includes package names, versions, and the precise actions the run would perform, giving teams confidence to proceed.
Approve & Execute
Once a dry-run is validated, a per-host audit trail records who approved what and when.
A single click can convert a validated plan into a real patch run, enabling centralized control with granular accountability.
Scheduled Patching
Patch policies enable scheduling: apply immediately, within a maintenance window, or as a staged rollout.
This flexibility helps minimize production impact and aligns with organizational change control.
Live Patch Streaming
As a patch run executes, you can watch the progress in real time from your browser.
Agent stdout/stderr streams over WebSocket, offering immediate insight and the ability to stop a run mid-flight if necessary.
Selective Patching
Target specific packages, apply security-only updates, or perform full upgrades.
Works across apt, dnf, yum, apk, pacman, and FreeBSD pkg, enabling consistent behavior across platforms.
Patch History & Audit
Every run is recorded with exit codes, duration, touched packages, approver, and host.
A searchable history enables post-mortems, compliance reporting, and audit readiness.
Visibility & Inventory
A clear view into your fleet is essential for proactive maintenance and risk management. PatchMon offers rich inventory and visibility capabilities.
Personalised Dashboard
Each user can customize their dashboard with draggable, reorderable cards that summarize fleet health, outdated packages, host status, and patching activity.
Personalization saves time by surfacing the most relevant metrics for each team member.
Host Inventory
A comprehensive catalog of enrolled hosts with OS, uptime, kernel version, last check-in, and group membership.
Quick search and filtering help teams locate endpoints that require attention.
Package Inventory
Discover every installed package across the fleet, identify outdated or vulnerable packages, and see which hosts need remediation.
Clear visibility into package-level risk supports targeted maintenance.
Repository Tracking
Keep track of APT, YUM, DNF, APK, and pacman repositories configured on each host.
A single view into repository configurations simplifies compliance checks and remediation planning.
Docker Monitoring
Automatic discovery of containers, images, volumes, and networks with real-time status.
Docker metrics stream over WebSocket, enabling rapid detection of container-level issues.
Reporting & Alerts Screenshot Notification Routing Screenshot
Security & Compliance
Security and compliance are integral to PatchMon’s design, helping teams measure risk and respond effectively.
Compliance Scanning
Run OpenSCAP CIS Benchmarks and Docker Bench for Security to assess posture.
Track compliance scores over time with per-rule results and remediation guidance.
Alerting
Stay informed with alerts for host-down events, pending updates, and agent version changes.
Filter alerts by severity, type, and status; assign to team members as needed.
Outbound-Only Agent
The agent initiates all traffic, reducing exposure by avoiding inbound ports on monitored hosts.
Enrolment tokens use IP allow-lists, and endpoint rate limiting protects the control plane.
RBAC
Multi-user accounts with customizable roles and granular permissions ensure that people see only what they need.
OIDC Single Sign-On
Authenticate with common providers like 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
PatchMon is designed to empower operators with powerful tools accessible directly from the UI.
Web SSH Terminal
Browser-based SSH to any enrolled host, with direct mode or proxy mode that routes through the agent (no SSH port exposure).
AI Terminal Assistant
An integrated AI chat panel inside the SSH terminal provides command suggestions, error diagnosis, and context-aware help.
Works with OpenRouter, Anthropic, OpenAI, or Google Gemini for flexible AI capabilities.
Branding & Theming
Personalize PatchMon with custom logos and favicons, color themes, and per-user light/dark mode.
AI Terminal Assistant Screenshot
Platform
The platform area describes PatchMon’s ecosystem of integrations and API access that empower automation and customization.
Integrations
PatchMon ships with 33+ integrations, including Proxmox LXC auto-enrolment, getHomepage, Ansible, and more.
The breadth of integrations makes it easier to embed PatchMon into existing workflows.
REST API
A fully documented REST API at /api/v1 with JWT authentication.
Interactive Swagger / OpenAPI docs are available at /api-docs for quick exploration and integration.
Architecture
PatchMon’s architecture is designed to be robust, scalable, and fault-tolerant. The backend is built with Go, using sqlc for type-safe database queries, and the chi router for lightweight, fast routing. The frontend is a React application embedded in the patchmon-server binary, reducing deployment complexity and ensuring a consistent user experience.
- Backend: Go, sqlc, chi router
- Frontend: React + Vite, embedded in the patchmon-server binary
- Database: PostgreSQL 17
- Queue: Redis 7 (Asynq)
- Agent: Go binary for Linux, FreeBSD, and Windows
A simplified depiction of how components interact is as follows: a browser-based admin UI communicates securely over HTTPS to the backend, which talks to PostgreSQL for data and Redis for asynchronous tasks. Agents on your servers talk back over encrypted channels (HTTPS and WebSocket) to the backend, delivering telemetry, patch results, and real-time events such as live patch streaming and Docker status. The architecture emphasizes outbound communication from agents, reducing the attack surface and simplifying network design.
[Mermaid Diagram] mermaid 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
Note: In real-world deployments, ensure that WebSocket traffic is enabled through your reverse proxy to support live streaming and real-time events.
Deployment Options
PatchMon ships with multiple deployment models to fit varied organizational needs, from fully managed cloud hosting to self-hosted on-premises.
PatchMon Cloud
- 14-day trial available at patchmon.net/pricing.
- Fully managed hosting with zero infrastructure overhead.
- PatchMon handles provisioning, updates, backups, and scaling, letting you focus on your fleet.
Self-Hosted - Docker (Officially Supported)
- Docker is the recommended self-hosted path.
- Automated setup from an empty directory that downloads the setup script, generates secrets, and walks you through configuration interactively.
- Sample commands:
- 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 configured URL (default: http://localhost:3000).
Manual Docker setup is also documented in the PatchMon docs.
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, onboarding hosts is a straightforward process:
- Log in to the UI and add a host under the Hosts section.
- PatchMon generates a one-line install command with a per-host API key.
- Paste the command on the target server (requires root or sudo) to enroll the agent.
- Supported agent platforms include Linux (amd64, 386, arm64, arm), FreeBSD (amd64, 386, arm64, arm), and Windows (amd64, 386, arm64).
Minimum Server Specs
- CPU: 2 vCPU
- RAM: 2 GB
- Disk: 15 GB
These specifications provide a baseline for testing and small-to-medium fleets; larger deployments will scale the control plane and database resources accordingly.
Documentation and Help
Comprehensive documentation is available at patchmon.net/docs, covering topics such as:
- Installing PatchMon on Docker
- Environment variables reference
- Integration API details
- Proxmox LXC auto-enrollment
- Retrieving getHomepage dashboard cards
- Metrics collection and telemetry
The docs are designed to help operators implement PatchMon quickly while providing advanced details for complex environments.
Support and Community
PatchMon maintains an active community and professional support options:
- Community
- Discord: patchmon.net/discord
- Email: [email protected]
- Professional & Enterprise
- PatchMon PRO: patchmon.net/pro
If you’re evaluating PatchMon for a larger deployment, the PRO offering provides enterprise-grade support, vendor assistance, and tailored integrations.
Contributing
PatchMon welcomes contributions from the community. The project emphasizes consistent coding style, test coverage, and documentation. Key guidelines include:
- 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 test suite passes.
- Update documentation alongside code changes.
Good first issues are labeled in the issue tracker, making it easier for new contributors to start.
[Getting involved via the repository issue tracker]
Roadmap
The PatchMon roadmap highlights upcoming features and progress. You can track developments at the PatchMon Roadmap page. The roadmap is designed to be a living document, reflecting user feedback, security improvements, and integrations that customers need in modern patch management workflows.
PatchMon PRO - Enterprise & Vendor Support
PatchMon is trusted by teams managing production infrastructure worldwide. The Pro/Enterprise offering expands on the open-source base with vendor support, custom integrations, and deployment options tailored to organizational needs. Key aspects include:
- PatchMon Cloud: Fully managed hosting with automated provisioning and scaling.
- Global Vendor Support: SLA-backed technical support services.
- Custom Integrations: Bespoke API endpoints, connectors, and dashboards tailored to your environment.
- On-Premises / Air-Gapped: Deploy PatchMon in isolated networks with full support.
- White-Label Solutions: Brand PatchMon as your own, with custom logos, domains, and multi-context deployment.
- Training & Onboarding: Structured programs to bring teams up to speed quickly.
- Consulting: Architecture review, deployment planning, and migration support from the PatchMon team.
If you’d like to explore enterprise options, contact [email protected] for more details.
Licensing
PatchMon is released under the AGPL v3 license. This aligns with the project’s open-source philosophy while enabling robust collaboration and community-driven improvements. A copy of the license is available in the LICENSE file.
Final Thoughts
PatchMon is more than a patching tool; it’s a security-conscious, scalable, and developer-friendly platform designed to bring order to the chaos of fleet management. By combining outbound-only agents with a modern architecture, PatchMon reduces complexity and risk while delivering actionable insights across Linux, FreeBSD, and Windows environments. With features spanning from granular patch orchestration to real-time telemetry and robust access control, PatchMon stands as a compelling option for teams seeking enterprise-grade patch management without the operational overhead of bespoke tooling.
Made with ❤️ by the PatchMon Team
Buy Me A Coffee (support link) Website Cloud Discord GitHub Docs
Enjoying this project?
Discover more amazing open-source projects on TechLogHub. We curate the best developer tools and projects.
Repository:https://github.com/9technologygroup/patchmon.net
GitHub - 9technologygroup/patchmon.net: PatchMon: Enterprise-grade Linux patch & server management platform
PatchMon is a next-generation operations platform designed to give IT and security teams a single pane of glass for monitoring, patching, and securing a diverse...
github - 9technologygroup/patchmon.net
Maintain PatchMon: Enterprise-grade Linux patch & server management platform? Add the badge to your README
Show that the project is featured on TechLogHub and send readers to this write-up.
[](https://techloghub.com/open-source/patchmon-enterprise-grade-linux-patch-server-management-platform?utm_source=techloghub_badge&utm_medium=referral&utm_campaign=readme)
