Skip to main content
Version: v1.4.0

Install CrowdSec (Linux)

For those that prefer hands-on approach, you can as well manually install crowdsec.

Install our repositories

Installing our repositories allows you to access the latest packages of CrowdSec and bouncers.

info

We are using packagecloud.io service. While curl | sudo bash can be convenient for some, alternative installation methods are available.

curl -s https://packagecloud.io/install/repositories/crowdsec/crowdsec/script.deb.sh | sudo bash

Install CrowdSec

apt install crowdsec

You now have CrowdSec running ! You can move forward and install a bouncer, or take a tour of the software beforehand !

Directories:

  • The application lives in the folder /etc/crowdsec using less than 0.5 MBytes of storage.
  • The data is stored in the folder /lib/crowdsec/data and needs around 97 MBytes of storage.
caution

Keep in mind that a CrowdSec package is only in charge of the "detection", and won't block anything on its own. You need to deploy a bouncer to "apply" decisions.

Install a bouncer

apt install crowdsec-firewall-bouncer-iptables
info

While we're suggesting the most common firewall bouncer, check our hub for more of them. Find a bouncer directly for your application (nginx, php, wordpress) or your providers (cloudflare, AWS/GCP/...)

Running CrowdSec on Raspberry Pi OS/Raspbian

Please keep in mind that Raspberry Pi OS is designed to work on all Raspberry Pi versions. Even if the port target is known as armhf, it's not exactly the same target as the debian named armhf port.

The best way to have a CrowdSec version for such an architecture is to do:

  1. install golang (all versions from 1.16 will do)
  2. export GOARCH=arm
  3. export CGO=1
  4. Update the GOARCH variable in the Makefile to arm
  5. install the arm gcc cross compiler (On debian the package is gcc-arm-linux-gnueabihf)
  6. Compile CrowdSec using the usual make command