Skip to main content
Version: v0.3

Migration from v0.X to v1.X


Migrating to V1.X will impact (any change you made will be lost and must be adapted to the new configuration) :

  • Database model : your existing database will be lost, a new one will be created in the V1.

  • CrowdSec configuration :

    • /etc/crowdsec/config/default.yaml
    • /etc/crowdsec/config/profiles.yaml

To upgrade CrowdSec from v0.X to v1, we'll follow those steps

Backup up configuration#

sudo cscli backup save /tmp/crowdsec_backupsudo cp -R  /etc/crowdsec/config/patterns /tmp/crowdsec_backup

Uninstall old version & install new#

Download latest V1 CrowdSec version here or use the from your downloaded package.

tar xvzf crowdsec-release.tgzcd crowdsec-v1*/sudo ./ --uninstall

Don't forget to remove Metabase dashboard if you installed it manually (without cscli).

Install latest version#

Follow the steps to install the latest version

Restore configuration#


Before restoring old backup, if you have local or tainted postoverflows, be aware that they are no longer compatible. You should update the syntax (the community and us are available to help you doing this part).

sudo cscli hub updatesudo cscli config restore --old-backup /tmp/crowdsec_backup/sudo cp -R /tmp/crowdsec_backup/patterns /etc/crowdsec/

Upgrade Bouncers#

If you were using Bouncers (formerly called blocker(s)), you need to replace them by the new compatibles Bouncers, available on the hub (selecting agent version to v1).

Following your bouncer type (netfilter, nginx, wordpress etc...), you need to replace them by the new available Bouncers on the hub, please follow the Bouncers documentation that will help you to install easily.

We're also available to help (on discourse or gitter) upgrading your Bouncers.