Skip to content
Ansible role for installing, configuring, and maintaining InfluxDB
Branch: master
Clone or download


An Ansible role to install, configure, and manage InfluxDB (a time-series database).


Prior knowledge/experience with InfluxDB is highly recommended. Full documentation is available here.


Either clone this repository, or install through Ansible Galaxy directly using the command:

ansible-galaxy install rossmcdonald.influxdb

Role Variables

The high-level variables are stored in the defaults/main.yml file. The most important one being:

# Channel of InfluxDB to install (stable, unstable, nightly)
influxdb_install_version: stable

More advanced configuration options are also stored in the defaults/main.yml file, which includes all of the necessary bells and whistles to tweak your configuration. There are more advanced runtime options available in the vars/main.yml file as well.


No other Ansible dependencies are required. This role was tested and developed with Ansible 1.9.4.


To test the role locally, it is recommended to either use Vagrant or Docker. There are a variety of available Dockerfiles in the /docker directory. For more information on building the images, please review the docker/ script.

To run a playbook within one of the Docker images, simply run:

docker run -v $(pwd):/root <DOCKER IMAGE> <PLAYBOOK>

For example, to run the included test.yml using the included CentOS 7 Docker image, run (after building the image):

docker run -v $(pwd):/root ansible.influxdb.centos7 test.yml

Example Playbook

An example playbook is included in the test.yml file. There is also a Vagrantfile, which can be used for quick local testing leveraging Vagrant, and a few Docker Dockerfiles located in the /docker directory.

Contributions and Feedback

Any contributions are welcome. For any bugs or feature requests, please open an issue through Github.




Created by Ross McDonald.

You can’t perform that action at this time.