Manual Installation

See the download page to download the packages.


Install the GPG public key:

wget -q -O- | sudo apt-key add -

Determine the codename of the Ubuntu/Debian release on your system:

. /etc/os-release && echo $VERSION
"14.04.4 LTS, Trusty Tahr" # codename for this system is "trusty"

Create an APT configuration file at /etc/apt/sources.list.d/sensu.list:

export CODENAME=your_release_codename_here # e.g. "trusty"
echo "deb $CODENAME main" | sudo tee /etc/apt/sources.list.d/sensu.list

Update APT:

sudo apt-get update

Install Uchiwa:

sudo apt-get install uchiwa


Create the YUM repository configuration file for the Sensu Core repository at /etc/yum.repos.d/sensu.repo:

echo '[sensu]
enabled=1' | sudo tee /etc/yum.repos.d/sensu.repo

Install Sensu:

sudo yum install sensu

Using Configuration Management

Chef: uchiwa-chef
Puppet: puppet-uchiwa
Ansible: ansible-uchiwa
SaltStack: sensu-formula

Using Docker

Uchiwa comes pre-packaged in a Docker container for easy deployment.

Download the official Uchiwa Docker image:

docker pull uchiwa/uchiwa

Create a folder that will contain the configuration files:

mkdir ~/uchiwa-config

Create and adjust the main configuration file:

vi ~/uchiwa-config/config.json

Start the Docker container:

docker run -d -p 3000:3000 -v ~/uchiwa-config:/config uchiwa/uchiwa

Browse Uchiwa:


From Source


This documentation provides instructions for advanced users who want to build their own packages. Otherwise, we highly recommend to use the system packages in order to get stable releases and an easier installation experience.



Download the source code:

go get -d && cd $GOPATH/src/

Build the Uchiwa binary:

go build -o build/uchiwa . # Build for your current system
GOOS=linux GOARCH=amd64 go build -o build/uchiwa . # Cross Compilation, see Go documentation

Front-end Assets

Install the front-end assets:

npm install --production # Standard user
npm install --production --unsafe-perm # Root user

Running Uchiwa Locally

Adjust your configuration:

cp config.json.example config.json

Start Uchiwa



See the Contributing documentation.