SEC.01
The playbook
The run starts read-only: the recon probes decide what happens next. The steps that follow are adapted to the distribution and state found — a real machine is rarely clean.
- 01reconthe distribution: apt (Debian/Ubuntu) or dnf (RHEL/Fedora/Rocky/Alma)
- 02reconCrowdSec already installed? version (allowlists ≥ 1.6.8)
- 03reconengine and bouncer active?
- 04reconports 8080 (LAPI) and 6060 (metrics) already taken by something other than crowdsec → change listen_uri
- 05reconCrowdSec repository already configured?
- 06reconfirewall backend (nftables or iptables bouncer); fail2ban can coexist
- 07reconopen SSH sessions and the admin IP that must never be blocked
- 08actAdd the CrowdSec repositoryverify
- 09actInstall CrowdSecverify
- 10actMove the LAPI (only if port 8080 was already taken)verify
- 11actCheck the Linux + SSH collectionsverify
- 12actProtect the admin IP (only if an IP is provided)verify
- 13actInstall the firewall bouncerverify
SEC.02
What it verifies
Each step ships its own check. The run only moves on when the check passes, so what the recipe reports as done is what is actually on the server.
- 01verifyAdd the CrowdSec repositoryVerified by
ls /etc/apt/sources.list.d/ /etc/yum.repos.d/ 2>/dev/null | grep -ci crowdsec - 02verifyInstall CrowdSecVerified by
cscli version && systemctl is-active crowdsec - 03verifyMove the LAPI (only if port 8080 was already taken)Verified by
cscli lapi status - 04verifyCheck the Linux + SSH collectionsVerified by
cscli collections list -o raw | grep -c 'crowdsecurity/sshd' - 05verifyProtect the admin IP (only if an IP is provided)Verified by
cscli allowlists inspect servor-admin - 06verifyInstall the firewall bouncerVerified by
systemctl is-active crowdsec-firewall-bouncer && cscli bouncers list
SEC.03
Guardrails
Non-negotiable instructions the run must respect, whatever it finds on the server.
The admin IP must be allowlisted BEFORE installing the bouncer. Never curl | sh: download the script, then run it. The LAPI stays on 127.0.0.1, never exposed. Do not touch existing firewall rules; if the admin IP gets banned: cscli decisions delete --ip <ip>.
SEC.04
Variables
What you choose before launching — the recipe fills in the rest.
| Name | Meaning |
|---|---|
| ${admin_ip} | Admin IP never to ban |
SEC.05
How a recipe runs in Servor
Servor is zero-knowledge: the platform cannot execute anything on its own. When you launch this recipe, a run reads the reconnaissance, plans the steps and asks for your approval. Each approved command is signed by your browser — with a key the server never sees — then relayed verbatim to the agent, which verifies the signature locally before executing.
search by intent — type “firewall”, get ufw
- 01Read-only reconnaissance before any change
- 02Every command signed by your browser, approved by you
- 03Each step verified before the run moves on, every run kept in the history
SEC.06
Deploy on Servor button
Maintain CrowdSec or a project that needs it? Put this button in your README or on your site: one click and your users install it on their own server.
SEC.07
More security recipes
- 01Harden SSHTurns off password login and root password login, keeps keys. Destructive: verify your key access first.
- 02fail2banfail2ban with the SSH jail on the right port, active and verified.
- 03UFW firewallUFW: denies incoming by default, allows the real SSH port + chosen ports, with a safety net. Destructive: keeps SSH open.
- 04Automatic security updatesEnables automatic security updates: unattended-upgrades (Debian/Ubuntu) or dnf-automatic (RHEL/Fedora).
- 05ClamAVClamAV antivirus with signatures kept up to date, optional daemon.
Verified recipe
Run this recipe on your server
Connect a server, launch the recipe, and approve each step as Servor executes and verifies it. Free plan, no card required.