# Zabbix - Installation de l'agent

<table id="bkmrk-difficult%C3%A9%2A-%3Cdescrip" style="border-collapse: collapse; width: 100%; height: 46.8px; border-width: 1px; border-style: hidden;"><colgroup><col style="width: 20%;"></col><col style="width: 80%;"></col></colgroup><tbody><tr style="height: 46.8px;"><td style="height: 46.8px; border: 1px groove rgb(52,73,94);">[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/KVCintermediaire-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/KVCintermediaire-png.png)  
</td><td style="height: 46.8px; border-width: 1px; background-color: rgb(236,202,250); vertical-align: top;">Difficulté : Intermédiaire

Notions : Supervision, agents, installation

</td></tr></tbody></table>

---

### <span style="color: rgb(52, 73, 94);">**<span style="text-decoration: underline;">I. Introduction</span>**</span>

Cette procédure à pour but d'expliquer l'installation de l'agent sur les différents systèmes utilisés dans le lab.

<p class="callout danger">**Prérequis** : générer une clé PSK pour l'échange du secret entre agents et serveur.</p>

```
Openssl rand -hex 32
```

ou utiliser un générateur en ligne comme : [https://www.browserling.com/tools/random-hex](https://www.browserling.com/tools/random-hex)


---

### <span style="text-decoration: underline; color: rgb(52, 73, 94);">**II. Installation de l'agent**</span>

#### 2.1 Installation Ubuntu

<details id="bkmrk-installation-et-para"><summary>Installation et paramétrage</summary>

##### 2.1.1 Installer l'agent

Récupérer le paquet sur le repo zabbix : [http://repo.zabbix.com/zabbix/](http://repo.zabbix.com/zabbix/)

exemple pour ubuntu 22.04 :

```bash
curl http://repo.zabbix.com/zabbix/6.5/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.5-1+ubuntu22.04_all.deb -o ./zabbix-release_6.5-1+ubuntu22.04_all.deb
```

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/8pIimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/8pIimage-png.png)

Installer le repo.

```
dpkg -i ./zabbix*.deb
```

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/e9Rimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/e9Rimage-png.png)

Installer l'agent.

```bash
apt update && apt install zabbix-agent
```

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/zSvimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/zSvimage-png.png)

Éditer le fichier '<span style="color: rgb(132,63,161);">***/etc/zabbix/zabbix\_agentd.conf***</span>' et modifier les lignes décrites ci-après.

##### 2.1.2 Configurer les checks passifs

Éditer la ligne suivante :

```
Server=127.0.0.1
```

en :

```
Server=<ip du ou des serveurs>
```

##### 2.1.3 Configurer les checks actifs

Éditer les lignes suivantes :

```
ServerActive=127.0.0.1
Hostname=Zabbix server
```

en :

```
ServerActive=<ip du ou des serveur>
Hostname=<FQDN du ou des serveur>
```

##### 2.1.4 (facultatif) activer PSK

Dé-commenter et éditer les lignes suivantes :

```
TLSConnect=psk
TLSAccept=psk
TLSPSKIdentity=unique_psk_identity
TLSPSKFile=/etc/zabbix/zabbix_agentd.psk
```

Il faudra ensuite créer et le remplir avec la clé précédemment générée.

```bash
echo <clé PSK> > /etc/zabbix/zabbix_agentd.psk
```

ou

```bash
echo $(openssl rand -hex 32) > /etc/zabbix/zabbix_agentd.psk
```

##### 2.1.5 Redémarrer les services

Redémarrer l'agent avec :

```
service zabbix-agent restart
```

</details>#### 2.2 Installation Windows

<details id="bkmrk-installation-et-para-1"><summary>Installation et paramétrage</summary>

Lancer l'exécutable d'installation.

Au premier écran, cliquer sur '<span style="color: rgb(132,63,161);">***Next***</span>'.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/aasimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/aasimage-png.png)

Accepter le contrat de licence et faire '<span style="color: rgb(132,63,161);">***next***</span>'.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/kUpimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/kUpimage-png.png)

Laisser l'ensemble des composants à l'installation, le chemin par défaut et faire '<span style="color: rgb(132,63,161);">***Next***</span>'.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/leVimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/leVimage-png.png)

Entrer les informations nécessaires :

- Host Name : laisser le nom du PC.
- Zabbix server : IP du serveur zabbix auquel se connectera l'agent.
- Server proxy : sauf si un proxy zabbix a été déployé, laisser la valeur par défaut.
- Si actif, cocher '<span style="color: rgb(132,63,161);">***Enable PSK***</span>' : cela permettra de chiffrer la communication entre l'agent et le serveur. 
    - Se référer à la [documentation officielle](https://www.zabbix.com/documentation/current/en/manual/encryption/using_pre_shared_keys)

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/b1Kimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/b1Kimage-png.png)

Si le PSK (**P**re **S**hared **K**ey) est activé, cette fenêtre sera à renseigner, sinon elle n'apparaîtra pas.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/PvIimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/PvIimage-png.png)

Lancer l'installation en cliquant sur '<span style="color: rgb(132,63,161);">***Installer***</span>'.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/k3Jimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/k3Jimage-png.png)

Attendre la fin de l'installation.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/Sy9image-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/Sy9image-png.png)

Une fois celle-ci terminée, cliquer sur '<span style="color: rgb(132,63,161);">***Finish***</span>'.

[![image.png](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/Vrpimage-png.png)](https://docs.labs404.fr/uploads/images/gallery/2026-07/scaled-1680-/Vrpimage-png.png)

</details>