Install Agent on Debian/Ubuntu with Packages

We recommend installing agent using standard method. If you use Docker, you can use Docker method. This page details step done by the shell script of standard method. If none of those methods fit your needs, see manual method.

Before installing Bleemeo agent, please check that you meet the system requirements.


The agent works with your native packaging tools. For Debian/Ubuntu the agent uses APT and deb package.

Our agent will need your credentials, get them from Bleemeo panel and add them to /etc/bleemeo/agent.conf.d/30-install.conf:

$ sudo mkdir -p /etc/bleemeo/agent.conf.d
$ sudo tee /etc/bleemeo/agent.conf.d/30-install.conf << EOF
    account_id: YOUR_ACCOUNT_ID
    registration_key: YOUR_REGISTRATION_KEY
$ sudo chmod 640 /etc/bleemeo/agent.conf.d/30-install.conf

Our package repository is signed with the following GPG key:

pub   4096R/FC23F27E 2015-11-25
      Key fingerprint = 9B8B DA4B E10E 9F23 28D4  0077 E848 FD17 FC23 F27E
uid                  Bleemeo Packaging Team <>

Import this key in APT keyring:

$ sudo apt-key adv --keyserver hkp:// --recv-keys 9B8BDA4BE10E9F2328D40077E848FD17FC23F27E

Our repository are available over HTTPS, make sure APT is configured to support it:

$ sudo apt-get install apt-transport-https

Add our repository for your distribution. For example on xenial:

$ dist_version=xenial
$ echo deb ${dist_version} main | sudo tee /etc/apt/sources.list.d/bleemeo-agent.list
$ echo deb ${dist_version} main | sudo tee /etc/apt/sources.list.d/bleemeo-telegraf.list


Don’t forget to update dist_version=xenial to match your current distribution. You may use lsb_release to find the correct value:

$ lsb_release -c
Codename:       xenial

Finally install Bleemeo agent package:

$ sudo apt-get update
$ sudo apt-get install bleemeo-agent