You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

9 Running agent as root

Since Zabbix 5.0.0, the systemd service file for Zabbix agent in official packages explicitly includes directives for User and Group. Both are set to zabbix.

It is no longer possible to configure which user Zabbix agent runs as via zabbix_agentd.conf file, because the agent will bypass this configuration and run as the user specified in the systemd service file. To run Zabbix agent as root you need to make the modifications described below.

Zabbix agent

To override the default user and group for Zabbix agent, run:

systemctl edit zabbix-agent
Copy
✔ Copied

Then, add the following content:

[Service]
       User=root
       Group=root
Copy
✔ Copied

Reload daemons and restart the zabbix-agent service:

systemctl daemon-reload
       systemctl restart zabbix-agent
Copy
✔ Copied

For Zabbix agent this re-enables the functionality of configuring user in the zabbix_agentd.conf file. Now you need to set User=root and AllowRoot=1 configuration parameters in the agent configuration file.

Zabbix agent 2

To override the default user and group for Zabbix agent 2, run:

systemctl edit zabbix-agent2
Copy
✔ Copied

Then, add the following content:

[Service]
       User=root
       Group=root
Copy
✔ Copied

Reload daemons and restart the zabbix-agent2 service:

systemctl daemon-reload
       systemctl restart zabbix-agent2
Copy
✔ Copied

For Zabbix agent2 this completely determines the user that it runs as. No additional modifications are required.

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.