Setup on Debian


Install the whole stack on a Debian-based system. The package repository supports architectures amd64 and armhf as of May 23, 2016.

It is currently made of these free and open source software components:

  • InfluxDB, a time-series database
  • MongoDB, a document store (optionally)
  • Grafana, a graph and dashboard builder for visualizing time series metrics
  • Mosquitto, a MQTT message broker
  • Kotori, a data acquisition, graphing and telemetry toolkit

Setup steps


Add https addon for apt:

apt install apt-transport-https software-properties-common

Register with package repository

Add source for “testing” distribution (will append to /etc/apt/sources.list):

apt-add-repository 'deb testing main foundation'

Add GPG key for checking package signatures:

wget -qO - | apt-key add -

Reindex package database:

apt update

Setup the whole software stack

Install Kotori as well as recommended and suggested packages:

DEPENDENCIES=$(LANG=c apt-cache depends $PACKAGES | egrep -i 'suggests|recommends' | grep -v '<' | cut -d' ' -f4 | xargs)
systemctl start influxdb grafana-server


You should keep your system time sound. Either carry out:

timedatectl set-ntp true

or install chrony:

apt install chrony

tail -F /var/log/kotori/.log /var/log/grafana/.log /var/log/influxdb/.log /var/log/mosquitto/.log journalctl -f -u influxdb

Getting started

Follow along at Getting started to configure and use your first Kotori application.