Document Docker installation

README.md

@@ -65,6 +65,56 @@ sudo chmod 0640 /etc/zabbix/ssl_targets.json
 
 Pas daarna `/etc/zabbix/ssl_targets.json` aan voor je eigen targets.
 
+## Installatie met Docker
+
+Gebruik je de officiële Zabbix Docker-images, dan is het meestal praktischer om external scripts en de target-config in het persistente Zabbix data-volume te zetten. Met jouw volumeconfig:
+
+```yaml
+volumes:
+  - /media/zabbix/zabbix-server-data:/var/lib/zabbix
+  - /media/zabbix/zabbix-snmptraps-data:/var/lib/zabbix/snmptraps
+  - /media/zabbix/zabbix-export-data:/var/lib/zabbix/export
+```
+
+kun je op de Docker-host deze paden gebruiken:
+
+```bash
+sudo install -d -o 1997 -g 1995 -m 0755 /media/zabbix/zabbix-server-data/externalscripts
+sudo install -o 1997 -g 1995 -m 0755 scripts/ssl_discovery.py /media/zabbix/zabbix-server-data/externalscripts/
+sudo install -o 1997 -g 1995 -m 0755 scripts/ssl_check.py /media/zabbix/zabbix-server-data/externalscripts/
+sudo install -o 1997 -g 1995 -m 0640 config/ssl_targets.json.example /media/zabbix/zabbix-server-data/ssl_targets.json
+```
+
+In de container worden deze bestanden dan zichtbaar als:
+
+```text
+/var/lib/zabbix/externalscripts/ssl_discovery.py
+/var/lib/zabbix/externalscripts/ssl_check.py
+/var/lib/zabbix/ssl_targets.json
+```
+
+Zet op de host `{$SSL_CONFIG}` in de gelinkte template of host-macro daarom op:
+
+```text
+/var/lib/zabbix/ssl_targets.json
+```
+
+Test daarna vanuit de Zabbix server-container. Vervang `zabbix-server` door de naam van jouw container:
+
+```bash
+docker exec -u zabbix zabbix-server /var/lib/zabbix/externalscripts/ssl_discovery.py --config /var/lib/zabbix/ssl_targets.json
+docker exec -u zabbix zabbix-server /var/lib/zabbix/externalscripts/ssl_check.py --config /var/lib/zabbix/ssl_targets.json --host home.blockje.nl --port 443
+```
+
+Als jouw image external scripts niet uit `/var/lib/zabbix/externalscripts` leest, mount dan expliciet naar de directory die in de container als `ExternalScripts` is ingesteld. Vaak is dat bij niet-Docker installaties `/usr/lib/zabbix/externalscripts`. Controleer bij twijfel de Zabbix server/proxy configuratie in de container.
+
+Let op met UID/GID: officiële Zabbix containers gebruiken vaak de `zabbix` gebruiker binnen de container. De numerieke `1997:1995` komt veel voor, maar kan per image verschillen. Als de testcommando's permission errors geven, controleer dan met:
+
+```bash
+docker exec zabbix-server id zabbix
+docker exec zabbix-server ls -l /var/lib/zabbix/externalscripts /var/lib/zabbix/ssl_targets.json
+```
+
 ## Configuratie
 
 Voorbeeld: