OSI Global › Guides › Patrowl

How to Install Patrowl: Open-Source Security Operations Orchestration

Patrowl orchestrates open-source scanners (Nmap, OWASP ZAP, Nessus connectors, SSL checks and more) into one dashboard for continuous asset scanning and findings management. This guide covers the Docker quick start and the hands-on OSI Global session.

Level: IntermediateTime: ~40 minutesDockerUpdated Nov 2026

Watch the hands-on session

Our community session installs and configures Patrowl Manager step by step (recorded on CentOS 7, about 1 h 49 min). The Docker method below works the same way on any current Linux.

Patrowl Installation Hands-on Session — video thumbnail▶Watch on YouTube: Patrowl Installation Hands-on Session

How Patrowl fits together

Requirements

Step 1 — Install Docker

curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER   # log out and back in

Step 2 — Get and start PatrowlManager

git clone https://github.com/Patrowl/PatrowlManager.git
cd PatrowlManager
docker compose build --force-rm
docker compose up -d

Step 3 — Sign in and change the default password

Open http://<server-ip>:8083/ and sign in with the default admin credentials from the project docs: admin / Bonjour1!. Change this password immediately, and don't expose port 8083 to the internet. Put it behind a reverse proxy with HTTPS or a VPN.

Step 4 — Add scan engines

git clone https://github.com/Patrowl/PatrowlEngines.git
cd PatrowlEngines
# build/run only the engines you need, e.g. the Nmap engine — see each engine's README

In the Manager go to Engines → Add, register each engine's URL, and click Refresh engines status until it shows Ready.

Step 5 — Run your first scan

  1. Assets → Add: a domain, IP or URL you own. Group related assets.
  2. Scans → Add scan definition: pick an engine policy (for example Nmap TCP top ports), select assets, choose one-time or periodic.
  3. Start it, then review Findings: severity, evidence and status. Set up alert rules (email, Slack) for new high-severity findings.
Patrowl is community-maintained. Check the GitHub repository for current release and maintenance status before you rely on it in production.
Written by Dr. Vivek Khare — Author, Speaker, IT Leader with 25+ years of experience, ISO 27001 Lead Auditor and founder of OSI Global. Spotted something out of date? Tell us via the community form.