Skip to main content
Version: Next

Getting Started

Welcome to CrowdSec!

This section will guide you through the installation of the Security Engine, and deployment of your first Remediation Component.


You may see CrowdSec referred to as "Security Engine" and Bouncers referred to as "Remediation Components" within new documentation. This is to better reflect the role of each component within the CrowdSec ecosystem.


If you would like to follow a step-by-step video to install Security Engine on a sandbox environment please follow our guide.

or follow the steps below.

Installation Security Engine


The Security Engine by default uses the following ports:

  • 8080/tcp for the API
  • 6060/tcp for the Prometheus metrics / Debugging

If these ports are not available on your system, you can change them in the configuration file post installation. See Configuration for more information.

Please note that the API is mandatory for your security engine, do not remove it from your configuration.

Using the repository

The easiest way to install the Security Engine is to use the official repository. This will ensure that you always have the latest version of the Security Engine.

Please see the relevant documentation for your OS:

Installing from source

If you wish to install from source, we have a short video guide on how to do this.

Installing a Remediation Component

Once you have installed the Security Engine, you can install a Remediation Component. This is the component that will take action on the decisions made by the Security Engine.

Depending on your network / OS setup, you will need to install a different Remediation Component.

If you are unsure which to install, please see our Remediation Components section OR join our discord and ask our community.