crowdsec/docs/getting_started/installation.md
Thibault bui Koechlin 1e3ade2b0e up binary install
2020-05-18 16:20:14 +02:00

1.9 KiB

Installation

Fetch {{crowdsec.name}}'s latest version here.

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

A {{wizard.name}} is provided to help you deploy {{crowdsec.name}} and {{cli.name}}.

Using the interactive wizard

sudo {{wizard.bin}} -i

crowdsec

The {{wizard.name}} 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.name}} 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.name}} !

Binary installation

you of little faith

sudo {{wizard.bin}} --bininstall

This will deploy a valid/empty {{crowdsec.name}} configuration files and binaries. Beware, in this state, {{crowdsec.name}} won't monitor/detect anything unless configured.

cscli install collection crowdsecurity/linux

Installing at least the crowdsecurity/linux collection will provide you :

  • syslog parser
  • geoip enrichment
  • date parsers

You will need as well to configure your {{ref.acquis}} file to feed {{crowdsec.name}} some logs.

From source

!!! warning "Requirements"

* [Go](https://golang.org/doc/install) v1.13+
* `git clone {{crowdsec.url}}`

Go in {{crowdsec.name}} folder and build the binaries :

cd crowdsec
make build

{{crowdsec.name}} bin will be located in ./cmd/crowdsec/crowdsec and {{cli.name}} bin in cmd/crowdsec-cli/{{cli.bin}}

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