Versions matrix
Maintenance policy
The last two releases are supported, see releases page for more details.
LTS versioning is not yet defined, but we are working on it.
Crowdsec is open-source, and as such, we may not be aware of all the channels of crowdsec distribution. Our official distribution channel is packagecloud.io for packages, and github
Matrix Versions
| OS | Platform | Distribution | Distribution Version | CrowdSec Version | CrowdSec Location |
|---|---|---|---|---|---|
| Linux | amd64/arm64/armhf | Debian | bookworm/bullseye/buster/stretch | 1.6.0 and 1.5.5 | packagecloud |
| Linux | amd64/arm64 | RedHat/CentOS | 6/7/8/9 | 1.6.0 and 1.5.5 | packagecloud |
| Linux | amd64/arm64 | Oracle Linux | 7/8/9 | 1.6.0 and 1.5.5 | packagecloud |
| Linux | amd64/arm64/armel/armhf/i386/mips64el/mipsel/ppc64el/s390x | Debian | 1.4.6 | official debian repository | |
| Linux | amd64/arm64 | Fedora | 38/39 | 1.6.0 (and 1.5.5 only for fc39) | packagecloud |
| Linux | amd64/arm64 | Amazon linux | 2 | 1.6.0 and 1.5.5 | packagecloud |
| Linux | amd64/arm64 | Ubuntu Linux | 16.04/18.04/20.04/22.04/22.10 | 1.6.0 and 1.5.5 | packagecloud |
| FreeBSD | amd64/i386 | N/A | 12 | 1.5.4 | freshports |
| FreeBSD | amd64/i386/arm64/armv7 | N/A | 13 | 1.5.4 | freshports |
| FreeBSD | amd64/i386 | N/A | 14 | 1.5.4 | freshports |
| FreeBSD | arm64/armv7 | N/A | 14 | 1.5.4 | freshports |
| OPNsense | amd64 | N/A | 23.7 | 1.5.4 | freshports |
| Windows | amd64 | to be defined | 1.6.0 | github releases | |
| Windows | amd64 | to be defined | 1.4.2 | chocolatey | |
| Linux | almost all OpenWRT supported platform | OpenWRT | 23.05 | 1.5.4 | OpenWrt repository |
| Linux/Windows | amd64/arm64 | docker | N/A | 1.5.4 | dockerhub |
| home assistant | amd64/arm64 | docker | N/A | 1.6.0 | crowdsecurity home assistant addon repo |
| helm chart | amd64/arm64 | helm | N/A | 1.6.0 | helm chart |
Note: There is a subtile difference between armel, armhf and armv7: armel and armhf are the ports name defined by debian, armel is available on armv6 capable processer and higher, and armhf is available on armv7 capable and higher.
Linux
Linux packages are maintained by CrowdSec and shipped through packagecloud.io repositories. Issues for packages have to be created directly against the crowdsec source repository. Packages are published automatically few hours after each new releases.
There are two public repositories:
- pkgcloud.io stable repository for published release
- pkgcloud.io beta repository for published release
Note: There is a version on official debian repository as well.
FreeBSD
FreeBSD ports are updated via requests to https://bugs.freebsd.org/bugzilla/
Anybody can open issues or even updates but most packages have an official maintainer (@mmetc for crowdsec). Issues are reviewed by maintainers, then by committers or by the ports management team. A proper review process is in place therefore updates can take a few days.
To see pending issues related to crowdsec or the bouncers, search "crowdsec". To see closed issues as well, search for "ALL crowdsec"
The state of the packages for the several FreeBSD versions and architectures can be seen at https://www.freshports.org/
Usually packages apprear in the repository updates (quarterly or latest), but if required they can be installed directly, for example:
$ pkg add https://pkg.freebsd.org/FreeBSD:12:amd64/latest/All/crowdsec-1.4.3.pkg
The repository for work-in-progress ports is https://github.com/crowdsecurity/packaging-freebsd, once tested they are submitted in bugzilla.
The following packages have been ported so far:
-
CrowdSec - https://github.com/freebsd/freebsd-ports/tree/main/security/crowdsec [1] packages: https://www.freshports.org/security/crowdsec/
-
Firewall Bouncer - https://github.com/freebsd/freebsd-ports/tree/main/security/crowdsec-firewall-bouncer packages: https://www.freshports.org/security/crowdsec-firewall-bouncer/
-
Blocklist Mirror - https://github.com/freebsd/freebsd-ports/tree/main/security/crowdsec-blocklist-mirror packages: https://www.freshports.org/security/crowdsec-blocklist-mirror
[1] read-only mirror of https://cgit.freebsd.org/ports/ also on https://gitlab.com/FreeBSD/freebsd-ports
OPNsense
OPNsense has its own port tree, which tracks the main branch from freebsd: https://github.com/opnsense/ports Updates are frequent (often daily) but can be delayed for code freeze or holidays. The source of the crowdsec plugin is in https://github.com/opnsense/plugins/tree/master/security/crowdsec and it depends on the crowdsec and firewall bouncer packages. New versions are pushed via pull requests on the github repository.
Windows
CrowdSec Windows releases are available for download few minutes after releasing directly on the release page of github.
We do our best to keep an up to date version in chocolatey repository as well. It has go through a moderation process, so we don't have any grasp on the publication timeline.
Issues have to be filed directly against the crowdsec source repository
