Document the Technitium DNS integration

README and INTEGRATIONS: what it reads, the config and token (15.0 or later),
the DNS test, the alerts and metrics, that its API has no CPU, memory or disk
figures, and how it differs from the Technitium DNS provider. ROLES: the page.
DATABASE: technitium_state, migrations to 0081, 91 tables. MONITORING: the
five alerts. PROMETHEUS-GRAFANA: the homelab_technitium_* metrics.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
bobbanandClaude Sonnet 5.5 committed 2026-11-01 21:52:20 +01:00
1 parent 312093d3f7
commit a2ff0f7daa
6 files changed
+64 -4

No files matched your search

+23 -2
View File
@@ -23,8 +23,8 @@ what the app actually creates.
|---|---|
| **File** | `DATABASE_PATH`, default `../data/homelab-manager.sqlite` (relative to `server/`; `/app/data/...` in Docker). The folder is created if missing. |
| **Foreign keys** | Switched on for every connection (`PRAGMA foreign_keys = ON`), so the `ON DELETE` rules below are enforced. |
| **Migrations** | SQL files in [`server/drizzle/`](server/drizzle) (`0000` … `0080`), applied automatically when the server starts. Which ones have run is recorded in the table `__drizzle_migrations`. |
| **Tables** | 90 application tables, plus drizzle's own `__drizzle_migrations`. |
| **Migrations** | SQL files in [`server/drizzle/`](server/drizzle) (`0000` … `0081`), applied automatically when the server starts. Which ones have run is recorded in the table `__drizzle_migrations`. |
| **Tables** | 91 application tables, plus drizzle's own `__drizzle_migrations`. |
**Not in the database, but beside it in the data folder:** the backups of the database itself (`backups/homelab-manager-….sqlite`, taken daily and on request; see [BACKUP.md](BACKUP.md)), and, only while a restore is waiting or has just happened, `restore-pending.sqlite` / `restore-pending.json` and `restore-result.json`.
@@ -78,6 +78,7 @@ erDiagram
integrations ||--o| fragnet_state : "cascade"
integrations ||--o| arr_state : "cascade"
integrations ||--o| adguard_state : "cascade"
integrations ||--o| technitium_state : "cascade"
integrations ||--o| grafana_state : "cascade"
integrations ||--o{ speedtest_results : "cascade"
integrations ||--o| netbox_state : "cascade"
@@ -1059,6 +1060,26 @@ How an AdGuard Home (an integration of type `adguard`) is right now, one row eac
How the last read went is kept in `settings`, key `_internal:adguardSync`.
#### `technitium_state`
How a Technitium DNS Server (an integration of type `technitium`) is right now, one row each, replaced at every read (every two minutes). `integration_id` is the primary key and a foreign key with **cascade**. No history: what is stored is the last good read, plus two clocks only this app can keep.
| Column | Type | Notes |
|---|---|---|
| `integration_id` | integer PK | |
| `version` | text | |
| `started_at` | text | ISO: when the DNS server last started (from its `uptimestamp`); null when it did not say. |
| `dns_port` | integer NOT NULL, default 53 | The port of its first listening endpoint. |
| `blocking_enabled` | integer NOT NULL, default 1 | Whether blocking is on. |
| `blocking_off_since` | text | ISO: the first read that showed blocking off; null while it is on. |
| `settings` | text NOT NULL | JSON: `{ blockLists: { count, intervalHours, nextUpdate }, cacheMaximumEntries, recursion, dnssecValidation }`. |
| `stats`, `zones`, `dhcp` | text | JSON: the last day's statistics (queries and how they ended, counts, the clients and names asked about most) · `{ total, disabled, issues: [{ name, problem }] }` · `{ scopes, enabledScopes, leases }`. **Null when they could not be read** (`dhcp` also when there is no DHCP server). |
| `probe` | text | JSON: the real DNS question — `{ ok, ms, error, name, host }`. |
| `probe_fail_since` | text | ISO: the first read in which the question went unanswered; null while it is answered. |
| `updated_at` | text NOT NULL | ISO. |
How the last read went is kept in `settings`, key `_internal:technitiumSync`.
#### `grafana_state`
How a Grafana (an integration of type `grafana`) is right now, one row each, replaced at every read (every five minutes). `integration_id` is the primary key and a foreign key with **cascade**. No history.