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.
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.
▶Watch on YouTube: Patrowl Installation Hands-on Session
How Patrowl fits together
- PatrowlManager: the web app: assets, scan definitions, findings, alerting and reports (Django + PostgreSQL + RabbitMQ).
- PatrowlEngines: separate containers that wrap each scanner (for example Nmap, SSL Labs, OWASP ZAP, VirusTotal). You run only the engines you need.
Requirements
- A VM with 4 vCPU, 8 GB RAM and 60 GB disk (the project's recommendation).
- Docker Engine and Docker Compose installed.
- Permission to scan the targets you add. Only scan assets you own or are authorised to test.
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
- Assets → Add: a domain, IP or URL you own. Group related assets.
- Scans → Add scan definition: pick an engine policy (for example Nmap TCP top ports), select assets, choose one-time or periodic.
- Start it, then review Findings: severity, evidence and status. Set up alert rules (email, Slack) for new high-severity findings.