Skip to main content
Version: v1.5.0

Cscli dashboard

"MySQL & PostgreSQL"

MySQL and PostgreSQL are currently not supported by cscli dashboard.

It means that you can run cscli dashboard only if you use SQLite (default) as storage database with your local API.

Dashboard

The cscli command cscli dashboard setup will use docker to install metabase docker image and fetch our metabase template to have a configured and ready dashboard.

tip

If you use podman instead of docker and want to install the crowdsec dashboard, you need to run:

sudo systemctl enable --now podman.socket export DOCKER_HOST=unix:///run/podman/podman.sock

Then you can setup the dashboard with sudo -E cscli dashboard setup.

Setup

Setup and Start crowdsec metabase dashboard

sudo cscli dashboard setup

Optional arguments:

  • -l |--listen : ip address to listen on for docker (default is 127.0.0.1)
  • -p |--port : port to listen on for docker (default is 8080)
  • --password : password for metabase user (default is generated randomly)
  • -f | --force : override existing setup
cscli dashboard setup
INFO[0000] Pulling docker image metabase/metabase       
...........
INFO[0002] creating container '/crowdsec-metabase'
INFO[0002] Waiting for metabase API to be up (can take up to a minute)
..............
INFO[0051] Metabase is ready

URL : 'http://127.0.0.1:3000'
username : 'crowdsec@crowdsec.net'
password : '<RANDOM_PASSWORD>'

tip

The dashboard setup command will output generated credentials for metabase.

Those are stored in /etc/crowdsec/metabase/metabase.yaml

Now you can connect to your dashboard, sign-in with your saved credentials then click on crowdsec Dashboard to get this:

Dashboard docker image can be managed by cscli and docker cli also. Look at the cscli help command using

sudo cscli dashboard -h

Remove the dashboard

Remove crowdsec metabase dashboard

sudo cscli dashboard remove [-f]

Optional arguments:

  • -f--force : will force remove the dashboard

Stop the dashboard

Stop crowdsec metabase dashboard

sudo cscli dashboard stop

Start the dashboard

Start crowdsec metabase dashboard

sudo cscli dashboard start

Note: Please look at this documentation for those of you that would like to deploy metabase without using docker.