Server Pi-Hole Alert

Ein Server zur Überwachung von Pi-Hole und automatischen Benachrichtigungen bei Problemen.

Projektstruktur

server-pi-hole-alert/
├── script/              # Hauptverzeichnis
│   ├── main.py         # Hauptanwendung
│   ├── config.json     # Konfigurationsdatei
│   ├── requirements.txt # Python-Abhängigkeiten
│   ├── README.md       # Diese Datei
│   ├── src/            # Quellcode-Module
│   ├── logs/           # Log-Dateien
│   └── tests/          # Tests

Installation

1. Repository klonen:

git clone https://github.com/tnt-nitro/server-pi-hole-alert.git
cd server-pi-hole-alert/script

1. Python Virtual Environment erstellen:

python -m venv venv
venv\Scripts\activate  # Windows

1. Abhängigkeiten installieren:

pip install -r requirements.txt

1. Konfiguration anpassen:

Für lokale Tests (empfohlen):

• Kopiere config_local.json.example zu config_local.json
• Bearbeite config_local.json und trage deine Pi-Hole URL und Token ein
• Diese Datei wird NICHT zu GitHub gepusht (sicher für sensible Daten)

Alternative (Standard-Konfiguration):

• Bearbeite config.json und trage Pi-Hole URL und Token ein
• Diese Datei wird zu GitHub gepusht (nur für nicht-sensible Standard-Werte)

Verwendung

python main.py

Konfiguration

Die Konfiguration erfolgt über config_local.json (wird bevorzugt) oder config.json.

Priorität:

1. config_local.json - für lokale Tests und sensible Daten (wird NICHT zu GitHub gepusht)
2. config.json - Standard-Konfiguration (wird zu GitHub gepusht)

Wichtige Einstellungen:

• server: Host und Port des Servers
• pi_hole: URL und API-Token des Pi-Hole
• alerts: Alert-Konfiguration (Email, Webhook)
• logging: Logging-Einstellungen

Hinweis: Verwende config_local.json für deine persönlichen Zugangsdaten und Test-Einstellungen!

Entwicklung

Das Projekt befindet sich in der Entwicklung.

Lizenz

[Lizenz hier eintragen]