From 3dddf55e5ef925c1c66b4825efaa81fbbea290e0 Mon Sep 17 00:00:00 2001
From: alvis <allogn@gmail.com>
Date: Sat, 21 Feb 2026 15:20:20 +0000
Subject: [PATCH] Add Zabbix monitoring service documentation

---
 Home.md   | 37 +++++++++++++++++++------------------
 Zabbix.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 65 insertions(+), 18 deletions(-)
 create mode 100644 Zabbix.md

diff --git a/Home.md b/Home.md
index 543d51c..5c227ee 100644
--- a/Home.md
+++ b/Home.md
@@ -1,18 +1,19 @@
-# Agap — Index
-
-## Infrastructure
-
-- [[Network]] — Netplan, Caddy, port forwarding
-- [[Storage]] — LVM setup
-
-## Services
-
-- [[Immich]] — Photo management and backup
-- [[Gitea]] — Git hosting
-- [[Open-WebUI]] — AI chat interface
-- [[Home-Assistant]] — KVM virtual machine
-- [[3X-UI]] — VPN proxy
-
-## Quick Start
-
-See [[Hello]] for an overview of Agap.
+# Agap — Index
+
+## Infrastructure
+
+- [[Network]] — Netplan, Caddy, port forwarding
+- [[Storage]] — LVM setup
+
+## Services
+
+- [[Immich]] — Photo management and backup
+- [[Gitea]] — Git hosting
+- [[Open-WebUI]] — AI chat interface
+- [[Home-Assistant]] — KVM virtual machine
+- [[3X-UI]] — VPN proxy
+- [Zabbix](Zabbix) — Monitoring (Zabbix 7.4, PostgreSQL, Apache)
+
+## Quick Start
+
+See [[Hello]] for an overview of Agap.
diff --git a/Zabbix.md b/Zabbix.md
new file mode 100644
index 0000000..b43a715
--- /dev/null
+++ b/Zabbix.md
@@ -0,0 +1,46 @@
+# Zabbix
+
+Monitoring stack — Zabbix 7.4 with PostgreSQL backend, Apache web frontend, and active agent.
+
+## Stack
+
+| Component | Image |
+|-----------|-------|
+| Zabbix Server | `zabbix/zabbix-server-pgsql:ubuntu-7.4-latest` |
+| Web Frontend | `zabbix/zabbix-web-apache-pgsql:ubuntu-7.4-latest` |
+| Agent (active) | `zabbix/zabbix-agent:ubuntu-7.4-latest` |
+| Database | `postgres:16-alpine` |
+
+## Access
+
+- URL: https://zb.alogins.net (Caddy → localhost:81)
+- Default credentials: `Admin` / `zabbix`
+
+## Config
+
+Directory: `agap_git/zabbix/`
+
+`.env` variables:
+
+| Variable | Description |
+|----------|-------------|
+| `WEB_PORT` | Host port for web frontend (81) |
+| `PHP_TZ` | Timezone for PHP/web |
+| `AGENT_HOSTNAME` | Hostname reported by agent |
+| `POSTGRES_DATA_DIR` | PostgreSQL data path (`/mnt/ssd/dbs/zabbix`) |
+| `POSTGRES_USER` | DB username |
+| `POSTGRES_PASSWORD` | DB password |
+| `POSTGRES_DB` | DB name |
+
+## Start
+
+```bash
+cd agap_git/zabbix
+docker compose up -d
+```
+
+## Notes
+
+- Agent runs in active mode only (`ZBX_PASSIVE_ALLOW=false`)
+- Zabbix server port 10051 is exposed on host for external agents
+- Database network is internal (not exposed)