How to Install PatchMon on Ubuntu 26.04

---

PatchMon is an open-source Linux patch management and monitoring platform that provides centralized visibility, patch automation, and compliance monitoring across Linux servers, FreeBSD systems, and Windows hosts.

This guide explains how to install the self-hosted Docker version of PatchMon on Ubuntu 26.04.

Update the System

---

Update all installed packages:

apt update -y

apt upgrade -y

Install Required Packages

---

Install required dependencies:

apt update

apt install curl jq bc docker.io -y

systemctl enable --now docker

curl -SL https://github.com/docker/compose/releases/latest/download/docker-compose-linux-$(uname -m) -o /usr/local/bin/docker-compose

chmod +x /usr/local/bin/docker-compose

ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Enable and start Docker:

systemctl enable --now docker

Verify Docker installation:

docker --version

Example output:

Docker version 29.1.3, build 29.1.3-0ubuntu4.1

Verify Docker Compose:

docker compose version

Create PatchMon Directory

---

Create a dedicated directory for PatchMon:

mkdir -p /opt/patchmon

cd /opt/patchmon

Run PatchMon Environment Setup

---

Download and run the official PatchMon Docker setup script:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/PatchMon/PatchMon/refs/heads/main/docker/setup-env.sh)"

The installer will prompt for:

• Server URL or IP
• CORS origin
• SSL preferences
• Environment configuration

Start PatchMon Containers

---

Launch PatchMon using Docker Compose:

docker-compose up -d

Check running containers:

docker ps

Output:

root@vps:/opt/patchmon# docker-compose up -d
[+] up 48/48
 ✔ Image redis:7-alpine                          Pulled                    10.1s
 ✔ Image guacamole/guacd:latest                  Pulled                    30.6s
 ✔ Image ghcr.io/patchmon/patchmon-server:latest Pulled                    37.1s
 ✔ Image postgres:17-alpine                      Pulled                    33.7s
 ✔ Network patchmon_patchmon-internal            Created                    0.2s
 ✔ Volume patchmon_postgres_data                 Created                    0.0s
 ✔ Volume patchmon_redis_data                    Created                    0.0s
 ✔ Container patchmon-guacd-1                    Healthy                    8.4s
 ✔ Container patchmon-database-1                 Healthy                    9.4s
 ✔ Container patchmon-redis-1                    Healthy                    6.4s
 ✔ Container patchmon-server-1                   Started                    8.5s

Configure Firewall (UFW)

---

Allow required ports:

ufw allow 3000/tcp

ufw allow 80/tcp

ufw allow 443/tcp

Enable firewall:

ufw --force enable

Check firewall status:

ufw status

Access PatchMon Web Interface

---

Open your browser and visit:

http://your-server-ip:3000

Replace your-server-ip with your actual server IP address or domain name.

You will now see the PatchMon setup page.

Create Administrator Account

---

Setup the initial administrator account and server details.

PatchMon Dashboard Overview:

Add Your First Host

---

Inside the PatchMon dashboard:

• Click on Add Host
• Select Linux / FreeBSD / Windows
• Copy the generated agent installation command
• Run it on the target server

PatchMon uses outbound-only agents, so monitored hosts do not require inbound firewall ports.

Viewing Available Package Updates

---

Once hosts are added successfully, PatchMon automatically scans and displays available package updates, system status, and patch information from the dashboard.

Available Updates Overview:

From this section you can:

• View pending package updates
• Monitor outdated packages
• Check system patch status
• Track host update compliance
• Manage updates centrally

Manage PatchMon Containers

---

Restart containers:

docker compose restart

Stop containers:

docker compose down

View logs:

docker compose logs -f

Update PatchMon:

cd /opt/patchmon

docker compose pull

docker compose up -d

🎉 You have successfully installed PatchMon on Ubuntu 26.04 using Docker.