Supported platforms and distributions

Sensu is available as packages, Docker images, and binary-only distributions. We recommend installing Sensu with one of our supported packages, Docker images, or configuration management integrations. Sensu downloads are provided under the Sensu commercial license.

Supported packages

Supported packages are available through sensu/stable on packagecloud and the downloads page.

Sensu backend

Platform and Version amd64
CentOS/RHEL 6, 7, 8 check mark
Debian 8, 9, 10 check mark
Ubuntu 14.04 check mark
Ubuntu 16.04 check mark
Ubuntu 18.04, 18.10 check mark
Ubuntu 19.04, 19.10 check mark
Ubuntu 20.04 check mark

Sensu agent

Platform and Version amd64 386
CentOS/RHEL 6, 7, 8 check mark
Debian 8, 9, 10 check mark
Ubuntu 14.04 check mark
Ubuntu 16.04 check mark
Ubuntu 18.04, 18.10 check mark
Ubuntu 19.04, 19.10 check mark
Ubuntu 20.04 check mark
Windows 7 and later check mark check mark
Windows Server 2008 R2 and later check mark check mark

Sensuctl command line tool

Platform and Version amd64 386
CentOS/RHEL 6, 7, 8 check mark
Debian 8, 9, 10 check mark
Ubuntu 14.04 check mark
Ubuntu 16.04 check mark
Ubuntu 18.04, 18.10 check mark
Ubuntu 19.04, 19.10 check mark
Ubuntu 20.04 check mark
Windows 7 and later check mark check mark
Windows Server 2008 R2 and later check mark check mark

Docker images

Docker images that contain the Sensu backend and Sensu agent are available for Linux-based containers.

Image Name Base
sensu/sensu Alpine Linux
sensu/sensu-rhel Red Hat Enterprise Linux

Binary-only distributions

Sensu binary-only distributions that contain the Sensu backend, agent, and sensuctl tool are available in .zip and .tar.gz formats.

Platform Architectures
Linux 386 amd64 arm64 armv5 armv6 armv7
MIPS MIPS LE MIPS 64 MIPS 64 LE
Windows 386 amd64
macOS amd64
FreeBSD 386 amd64
Solaris amd64

Linux

Sensu binary-only distributions for Linux are available for these architectures and formats:

Architecture Formats Architecture Formats
386 .tar.gz | .zip MIPS hard float .tar.gz | .zip
amd64 .tar.gz | .zip MIPS soft float .tar.gz | .zip
arm64 .tar.gz | .zip MIPS LE hard float .tar.gz | .zip
armv5 (agent and CLI) .tar.gz | .zip MIPS LE soft float .tar.gz | .zip
armv6 (agent and CLI) .tar.gz | .zip MIPS 64 hard float .tar.gz | .zip
armv7 (agent and CLI) .tar.gz | .zip MIPS 64 soft float .tar.gz | .zip
MIPS 64 LE hard float .tar.gz | .zip MIPS 64 LE soft float .tar.gz | .zip

NOTE: 32-bit systems cannot run the Sensu backend reliably, so armv5, armv6, and armv7 packages include the agent and CLI only. In addition, all MIPS packages include only the agent and CLI.

For binary distributions, we support the following Linux kernels:

  • 3.1.x and later for armv5
  • 4.8 and later for MIPS 64 LE hard float and MIPS 64 LE soft float
  • 2.6.23 and later for all other architectures

For example, to download Sensu for Linux amd64 in tar.gz format:

curl -LO https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.20.2/sensu-go_5.20.2_linux_amd64.tar.gz

Generate a SHA-256 checksum for the downloaded artifact:

sha256sum sensu-go_5.20.2_linux_amd64.tar.gz

The result should match the checksum for your platform:

curl -LO https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.20.2/sensu-go_5.20.2_checksums.txt && cat sensu-go_5.20.2_checksums.txt

Windows

Sensu binary-only distributions for Windows are available for these architectures and formats:

Architecture Formats
amd64 .tar.gz | .zip
386 .tar.gz | .zip

We support Windows 7 and later and Windows Server 2008R2 and later for binary distributions.

For example, to download Sensu for Windows amd64 in zip format:

Invoke-WebRequest https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.20.2/sensu-go_5.20.2_windows_amd64.zip  -OutFile "$env:userprofile\sensu-go_5.20.2_windows_amd64.zip"

Generate a SHA-256 checksum for the downloaded artifact:

Get-FileHash "$env:userprofile\sensu-go_5.20.2_windows_amd64.zip" -Algorithm SHA256 | Format-List

The result should match (with the exception of capitalization) the checksum for your platform:

Invoke-WebRequest https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.20.2/sensu-go_5.20.2_checksums.txt -OutFile "$env:userprofile\sensu-go_5.20.2_checksums.txt"

Get-Content "$env:userprofile\sensu-go_5.20.2_checksums.txt" | Select-String -Pattern windows_amd64

macOS

Sensu binary-only distributions for macOS are available for these architectures and formats:

Architecture Formats
amd64 .tar.gz | .zip

We support macOS 10.11 and later for binary distributions.

For example, to download Sensu for macOS amd64 in tar.gz format:

curl -LO https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.20.2/sensu-go_5.20.2_darwin_amd64.tar.gz

Generate a SHA-256 checksum for the downloaded artifact:

shasum -a 256 sensu-go_5.20.2_darwin_amd64.tar.gz

The result should match the checksum for your platform:

curl -LO https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.20.2/sensu-go_5.20.2_checksums.txt && cat sensu-go_5.20.2_checksums.txt

Extract the archive:

tar -xvf sensu-go_5.20.2_darwin_amd64.tar.gz

Copy the executable into your PATH:

sudo cp sensuctl /usr/local/bin/

FreeBSD

Sensu binary-only distributions for FreeBSD are available for these architectures and formats:

Architecture Formats
amd64 .tar.gz | .zip
386 .tar.gz | .zip

We support FreeBSD 11.2 and later for binary distributions.

For example, to download Sensu for FreeBSD amd64 in tar.gz format:

curl -LO https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.20.2/sensu-go_5.20.2_freebsd_amd64.tar.gz

Generate a SHA-256 checksum for the downloaded artifact:

sha256sum sensu-go_5.20.2_freebsd_amd64.tar.gz

The result should match the checksum for your platform:

curl -LO https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.20.2/sensu-go_5.20.2_checksums.txt && cat sensu-go_5.20.2_checksums.txt

Solaris

Sensu binary-only distributions for Solaris are available for these architectures and formats:

Architecture Formats
amd64 .tar.gz | .zip

We support Solaris 11 and later (not SPARC) for binary distributions.

For example, to download Sensu for Solaris amd64 in tar.gz format:

curl -LO https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.20.2/sensu-go_5.20.2_solaris_amd64.tar.gz

Generate a SHA-256 checksum for the downloaded artifact.

sha256sum sensu-go_5.20.2_solaris_amd64.tar.gz

The result should match the checksum for your platform.

curl -LO https://s3-us-west-2.amazonaws.com/sensu.io/sensu-go/5.20.2/sensu-go_5.20.2_checksums.txt && cat sensu-go_5.20.2_checksums.txt

The Sensu Push utility allows you to execute Sensu checks on legacy systems and other platforms that cannot run the Sensu agent, such as AIX and SPARC Solaris.

You can also use cron to run Sensu checks locally on these systems and forward the results to an upstream Sensu backend or agent via the Sensu API.

Build from source

Sensu Go’s core is open source software, freely available under an MIT License. Sensu Go instances built from source do not include commercial features such as the web UI homepage. See the feature comparison matrix to learn more. To build Sensu Go from source, see the contributing guide on GitHub.