Installation

For instructions on how to install the Debian package from a file, please see the downloads page.

Debian and Ubuntu users can install the latest stable version of Telegraf using the apt-get package manager.

For Ubuntu users, add the InfluxData repository with the following commands:

  curl -sL https://repos.influxdata.com/influxdata-archive_compat.key | sudo apt-key add -
  source /etc/lsb-release
  echo "deb https://repos.influxdata.com/${DISTRIB_ID,,} ${DISTRIB_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/influxdb.list

For Debian users, add the InfluxData repository with the following commands:

  curl -sL https://repos.influxdata.com/influxdata-archive_compat.key | sudo apt-key add -
  source /etc/os-release
  test $VERSION_ID = "7" && echo "deb https://repos.influxdata.com/debian wheezy stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
  test $VERSION_ID = "8" && echo "deb https://repos.influxdata.com/debian jessie stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
  test $VERSION_ID = "9" && echo "deb https://repos.influxdata.com/debian stretch stable" | sudo tee /etc/apt/sources.list.d/influxdb.list

Then, install and start the Telegraf service:

  sudo apt-get update && sudo apt-get install telegraf
  sudo service telegraf start

Or if your operating system is using systemd (Ubuntu 15.04+, Debian 8+):

  sudo apt-get update && sudo apt-get install telegraf
  sudo systemctl start telegraf

For instructions on how to install the RPM package from a file, please see the downloads page.

RedHat and CentOS users can install the latest stable version of Telegraf using the yum package manager:

  cat <<EOF | sudo tee /etc/yum.repos.d/influxdb.repo
  [influxdb]
  name = InfluxDB Repository - RHEL \$releasever
  baseurl = https://repos.influxdata.com/rhel/\$releasever/\$basearch/stable
  enabled = 1
  gpgcheck = 1
  gpgkey = https://repos.influxdata.com/influxdata-archive_compat.key
  EOF

Once repository is added to the yum configuration, install and start the Telegraf service by running:

  sudo yum install telegraf
  sudo service telegraf start

Or if your operating system is using systemd (CentOS 7+, RHEL 7+):

  sudo yum install telegraf
  sudo systemctl start telegraf

There are RPM packages provided by openSUSE Build Service for SUSE Linux users:

  # add go repository
  zypper ar -f obs://devel:languages:go/ go
  # install latest telegraf
  zypper in telegraf

Telegraf is part of the FreeBSD package system. It can be installed by running:

  sudo pkg install telegraf

The configuration file is located at /usr/local/etc/telegraf.conf with examples in /usr/local/etc/telegraf.conf.sample.

Users of macOS 10.8 and higher can install Telegraf using the Homebrew package manager. Once brew is installed, you can install Telegraf by running:

  brew update
  brew install telegraf

To have launchd start telegraf at next login:

  ln -sfv /usr/local/opt/telegraf/*.plist ~/Library/LaunchAgents

To load telegraf now:

  launchctl load ~/Library/LaunchAgents/homebrew.mxcl.telegraf.plist

Or, if you don’t want/need launchctl, you can just run:

  telegraf -config /usr/local/etc/telegraf.conf

Install Telegraf as a Windows service (Windows support is still experimental):

  telegraf.exe -service install -config <path_to_config>