AdGuard Home

Installieren

Auf der Proxmox-Node als root:

bash -c "$(curl -fsSL https://iac.heyer.systems/adguard/ct.sh)"

Container aus dem Debian-13-Template · Standard: 1 CPU, 512 MiB RAM, 4 GiB Disk

Eigene Werte (CPU, RAM, Netzwerk, Module …) ohne Dialog: Generator

Danach: Weboberfläche: http://<IP>:3000/ (Login: admin; Passwort im Gast: grep adguard_admin_password /etc/iac/settings.env) · DNS: <IP>

Generator Einstellungen zusammenklicken, Befehl kopieren

Ressourcen

CPU-Kerne RAM MiB Disk GiB

System

Hostname ID leer = nächste freie Storage leer = erster passender

Netzwerk

DHCP Statische IP

DNS-Server leer = wie die Node Suchdomain

Bridge VLAN-Tag

Module

Backup (restic)Tägliche Sicherung mit restic nach SFTP, S3, REST-Server oder lokal – /etc, /root, /var/lib, die Daten der App und Datenbank-Dumps. Ziel: backup_repository in /etc/iac/settings.env Desktop (XFCE, RDP)XFCE-Desktop mit Firefox per RDP (Port 3389, nur private Netze). Login als root, Passwort: grep root_password /etc/iac/settings.env fail2banSperrt IP-Adressen nach wiederholten Fehlversuchen beim SSH-Login (nftables); eigene Jails für App-Logins möglich MariaDBMariaDB-Server aus Debian, nur über localhost erreichbar Prometheus node exporterSystem-Metriken auf Port 9100 (nur private Netze) PostgreSQLPostgreSQL-Server aus Debian, nur über localhost erreichbar Automatische SicherheitsupdatesDebian-Sicherheitsupdates täglich automatisch einspielen (ohne Neustart) Valkey (Redis)Valkey-Server aus Debian (Redis-Protokoll), nur über localhost:6379

Zugang

SSH-Keys URL, leer = authorized_keys der Node

Docker

Verzeichnis

Port 53 DNS TCP Port 53 DNS UDP Port 3000 AdGuard-Weboberfläche

Host-Port, optional mit Adresse – z. B. 8081 oder 127.0.0.1:8080.

Aktualisieren

Im Gast:

update

Debian-Pakete, AdGuard Home, Module und die iac-Konfiguration. Major-Versionen wechseln nie automatisch.

Module nachrüsten – jederzeit, im Container wie in der VM:

update --list-modules
update --add-modules node-exporter

Alle Module · Mehr zu update

Bestehende Installation übernehmen im Gast als root

bash -c "$(curl -fsSL https://iac.heyer.systems/adguard/adopt.sh)"

Prüft zuerst und bricht vor jeder Änderung ab, wenn eine automatische Übernahme nicht möglich ist – dann gilt die Migrationsanleitung.