Installing and maintaining zabbix-proxy for RedHat/Debian/Ubuntu.
Clone or download
Latest commit 5a73d43 Nov 19, 2018

Table of Content

Build Status


This is an role for installing and maintaining the zabbix-proxy.

This is one of the 'dj-wasabi' roles which configures your whole zabbix environment. See an list for the complete list:



With this 1.0.0 release, the following is changed:

  • All properties starts with zabbix_ now. Example, property named proxy_dbhost is now zabbix_proxy_dbhost.

Operating systems

This role will work on the following operating systems:

  • Red Hat
  • Debian
  • Ubuntu

So, you'll need one of those operating systems.. :-) Please sent Pull Requests or suggestions when you want to use this role for other Operating systems.

Zabbix Versions

See the following list of supported Operating systems with the Zabbix releases.

Zabbix 4.0

  • CentOS 7.x
  • Amazon 7.x
  • RedHat 7.x
  • OracleLinux 7.x
  • Scientific Linux 7.x
  • Ubuntu 14.04, 16.04, 18.04
  • Debian 8, 9

Zabbix 3.4

  • CentOS 7.x
  • Amazon 7.x
  • RedHat 7.x
  • OracleLinux 7.x
  • Scientific Linux 7.x
  • Ubuntu 14.04, 16.04
  • Debian 7, 8, 9

Zabbix 3.2

  • CentOS 7.x
  • Amazon 7.x
  • RedHat 7.x
  • OracleLinux 7.x
  • Scientific Linux 7.x
  • Ubuntu 14.04, 16.04
  • Debian 7, 8

Zabbix 3.0

  • CentOS 5.x, 6.x, 7.x
  • Amazon 5.x, 6.x, 7.x
  • RedHat 5.x, 6.x, 7.x
  • OracleLinux 5.x, 6.x, 7.x
  • Scientific Linux 5.x, 6.x, 7.x
  • Ubuntu 14.04
  • Debian 7, 8

Zabbix 2.4

  • CentOS 6.x, 7.x
  • Amazon 6.x, 7.x
  • RedHat 6.x, 7.x
  • OracleLinux 6.x, 7.x
  • Scientific Linux 6.x, 7.x
  • Ubuntu 12.04 14.04
  • Debian 7

Zabbix 2.2

  • CentOS 5.x, 6.x
  • RedHat 5.x, 6.x
  • OracleLinux 5.x, 6.x
  • Scientific Linux 5.x, 6.x
  • Ubuntu 12.04
  • Debian 7

Role Variables

There are some variables in de default/main.yml which can (Or needs to) be changed/overriden:

  • zabbix_server_host: The ip or dns name for the zabbix-server machine.

  • zabbix_server_port: The port on which the zabbix-server is running. Default: 10051

  • zabbix_version: This is the version of zabbix. Default it is 2.4, but can be overriden to 2.2 or 2.0.

  • zabbix_repo: True / False. When you already have an repository with the zabbix components, you can set it to False.

There are some zabbix-proxy specific variables which will be used for the zabbix-proxy configuration file, these can be found in the default/main.yml file. There are 2 which needs some explanation:

  #zabbix_proxy_database: mysql
  #zabbix_proxy_database_long: mysql
  zabbix_proxy_database: pgsql
  zabbix_proxy_database_long: postgresql

There are 2 database_types which will be supported: mysql and postgresql. You'll need to comment or uncomment the database you would like to use. In example from above, the postgresql database is used. If you want to use mysql, uncomment the 2 lines from mysql and comment the 2 lines for postgresql.

If you use mysql, then you should define mysql username, password and host to prepare zabbix database, otherwise they will be considered as their default value (and therefor, connecting to database will be considered as connecting to localhost with no password). the keys are belows: zabbix_proxy_mysql_login_host zabbix_proxy_mysql_login_user zabbix_proxy_mysql_login_password


You'll need to find the correct database role by yourself. I only want to use roles which supports the 3 main operating systems as well and for now I can't find one. If there is an role which supports these 3 operating systems, please let me know and I'll use it as dependency.

Example Playbook

Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:

- hosts: zabbix-proxy
  sudo: yes
     - { role: dj-wasabi.zabbix-proxy, zabbix_server_host:, database_type: pgsql, database_type_long: postgresql }



Author Information

This is my first attempt to create an ansible role, so please send suggestion or pull requests to make this role better.


mail: ikben [ at ] werner-dijkerman . nl