Skip to main content

CrowdSec Console

The CrowdSec Console is a web interface for managing your CrowdSec Security Engines. It provides dashboards and activity views to make monitoring and analysis easier.

The Console also lets you add advanced features, including third-party blocklists, so you can extend protection with external intelligence.

Your first enrollment​

This guide assumes CrowdSec is already installed. If not, start with one of these guides:

Sign Up​

Head over to the CrowdSec Console and sign up for a new account.

CrowdSec Signup ScreenCrowdSec Signup Screen

Verify Email​

After signing up, you will receive a verification email. Click the link or enter the code to verify your account.

Missing Email?​

If you do not receive an email, check your spam folder. If it is still missing, click "Resend verification email" on the login page.

If more than 5 minutes have passed, contact us.

Survey​

When you log in for the first time, we ask a few questions to understand your use case.

CrowdSec SurveyCrowdSec Survey

The survey is optional. We use the information to tailor your experience and better understand users.

Engines page​

After signing up, the first page you see is the engines page, where you can view enrolled engines and their status.

CrowdSec Enrollment KeyCrowdSec Enrollment Key

Since this is your first enrollment, you will not see any engines yet. Let's enroll one.

At the bottom of the page, you will see a code card with a command to run on your engine. This enrolls it to your account.

$ENROLLMENT_KEY is a placeholder for your actual enrollment key.

sudo cscli console enroll $ENROLLMENT_KEY
Command Output
INFO[2024-02-21T16:50:17Z] manual set to true
INFO[2024-02-21T16:50:17Z] Enabled manual : Forward manual decisions to the console
INFO[2024-02-21T16:50:17Z] Enabled tainted : Forward alerts from tainted scenarios to the console
INFO[2024-02-21T16:50:17Z] Watcher successfully enrolled. Visit https://app.crowdsec.net to accept it.
INFO[2024-02-21T16:50:17Z] Please restart crowdsec after accepting the enrollment.

Accept enrollment​

Once you execute the command, a new engine appears on the engines page. Select it and click "Accept enroll."

CrowdSec Accept EnrollmentCrowdSec Accept Enrollment

If you do not see the engine, use the refresh button near "Add Security Engine".

Restart CrowdSec​

After accepting the enrollment, restart the CrowdSec service.

sudo systemctl restart crowdsec

Restarting is not critical immediately, but it ensures metadata is fully synchronized.

Next steps​

Now that your first engine is enrolled, explore the Console features:

If you want to follow the full setup, return to the post-installation steps.