Skip to content


Fetch crowdsec-agent's latest version here.

tar xvzf crowdsec-release.tgz
cd crowdsec-v1.X.X

A wizard is provided to help you deploy crowdsec-agent and cscli.

Using the interactive wizard

sudo ./ -i


The wizard is going to guide you through the following steps :

  • detect services that are present on your machine
  • detect selected services logs
  • suggest collections (parsers and scenarios) to deploy
  • deploy & configure crowdsec-agent in order to watch selected logs for selected scenarios

The process should take less than a minute, please report if there are any issues.

You are then ready to take a tour of your freshly deployed crowdsec-agent !


Keep in mind the crowdsec-agent is only in charge of the "detection", and won't block anything on its own. You need to deploy a bouncers to "apply" decisions.

Binary installation

you of little faith

sudo ./ --bininstall

This will only deploy the binaries, and some extra installation steps need to be completed for the software to be functional :

  • sudo cscli hub update : update the hub index
  • sudo cscli machines add -a : register crowdsec to the local API
  • sudo cscli capi register : register to the central API
  • sudo cscli collections install crowdsecurity/linux : install essential configs (syslog parser, geoip enrichment, date parsers)
  • configure your sources in your acquisition : /etc/crowdsec/acquis.yaml

You can now start & enable the crowdsec service :

  • sudo systemctl start crowdsec
  • sudo systemctl enable crowdsec

Using the unattended wizard

If your setup is standard and you've walked through the default installation without issues, you can win some time in case you need to perform a new install : sudo ./ --unattended

This mode will emulate the interactive mode of the wizard where you answer yes to everything and stick with the default options.

From source


  • Go v1.13+
  • git clone
  • jq

Go in crowdsec-agent folder and build the binaries :

cd crowdsec
make release

This will create you a directory (crowdsec-vXXX/) and an archive (crowdsec-release.tgz) that are release built from your local code source.

Now, you can install either with interactive wizard or the unattended mode.