# PatchMon

PatchMon is a patch management platform that monitors, approves, and deploys Linux updates across your servers, with support for FreeBSD and Windows agents. It is open source and self-hosted, installable on Proxmox.

Canonical page: https://ourlocalhost.com/app/4573/patchmon

## Description

PatchMon is a patch management platform that monitors, approves, and deploys Linux updates across your servers, with support for FreeBSD and Windows agents. A lightweight outbound-only agent sends each host's pending patches to a central UI where you apply policy, schedule changes, and keep a full audit trail. It is built for operations teams and homelabbers who want one place to keep their Linux fleet patched without juggling SSH sessions or one-off scripts.

## Platform availability

Available on 3 of 10 platforms: Unraid, Proxmox, Any server.

## Health score

74/100 (Good), based on 4 of 4 factors.
- Maintained: 100 (last commit 12 days ago)
- Popular: 71 (3,659 GitHub stars)
- Easy to install: 45 (3 install platforms, install notes)
- Light to run: 50 (2 GB minimum RAM)

## Links

- GitHub: https://github.com/PatchMon/PatchMon
- Official website: https://patchmon.net
- Documentation: https://patchmon.net/docs
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=patchmon

## Common questions

### Does the PatchMon agent require inbound ports?

No. The lightweight agent communicates outbound-only to the PatchMon server on your schedule, with no inbound ports required.

### How do I start PatchMon for the first time with Docker?

Create a patchmon folder, run the setup script, and start the app with docker compose up -d. Then open the local UI on port 3000 to create your admin account and add hosts.

### What .env values are required if I do not use the PatchMon setup script?

Create .env from env.example and set strong POSTGRES_PASSWORD, REDIS_PASSWORD, and JWT_SECRET values. Without them PatchMon cannot safely run its database, cache, or sign-in tokens.

### How do I connect an agent to a running PatchMon server?

Use the agent set-api command with the agent’s API ID, API key, and your PatchMon URL. The agent then connects and reports which packages need updates.

### Is there a community project that links Checkmk and PatchMon?

Yes, a community project links Checkmk and PatchMon. PatchMon makes needed security updates on Linux and FreeBSD servers visible.

---
Source: Our Local Host (https://ourlocalhost.com/app/4573/patchmon), the self-hosted and open-source app directory.
