⚠️ DISCLAIMER / HAFTUNGSAUSSCHLUSSThis code is AI-generated and untested. AI can make errors - human oversight and testing is mandatory. All code is open source and in BETA status. Use at your own risk.
Dieser Code ist KI-generiert und ungetestet. KI kann Fehler machen - menschliche Überprüfung und Tests sind zwingend erforderlich. Der gesamte Code ist Open Source und im BETA-Status. Verwendung auf eigene Gefahr.
Ein selbst-gehostetes, kosteneffizientes Notification-System für SMS, WhatsApp, Signal, Teams und E-Mail
Entwickelt von WebPoint Internet Solutions | Ein Konzept von Alexander Waller und Claude AI
Alarma! ist eine Docker-basierte Lösung, die es ermöglicht, Benachrichtigungen über mehrere Kanäle zu versenden - gesteuert über eine einzige API. Das System nutzt ein Android-Smartphone als Gateway für SMS, WhatsApp und Signal, wodurch teure Cloud-Provider überflüssig werden.
- 🆓 Keine Cloud-Kosten - Vollständig selbst-gehostet
- 📱 Android als Gateway - Bestehende Hardware nutzen
- 🎯 Ein API-Endpunkt - Für alle Kanäle
- 🔧 Docker-basiert - In 30 Minuten einsatzbereit
- 🔒 Open Source - Keine Vendor Lock-ins
- 💰 ROI in 4 Monaten - Einsparung von ~€700/Jahr
- 🛡️ Ausfallsicher - SMS funktioniert auch ohne Internet (Mobilfunknetz)
| Kanal | Gateway | Status |
|---|---|---|
| SMTP | ✅ Ready | |
| 📱 SMS | Android App | ✅ Ready |
| Android App | ✅ Ready | |
| 🔐 Signal | signal-cli | ✅ Ready |
| 👔 Microsoft Teams | Webhook | ✅ Ready |
| 🔔 Push (ntfy) | ntfy.sh | ✅ Ready |
┌──────────────────────────────────────────────────────────────────────┐
│ EXTERNE SYSTEME & TRIGGER │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ PRTG │ │ PowerShell │ │ Scripts │ │
│ │ Monitor │ │ Module │ │ & APIs │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
└─────────┼──────────────────┼──────────────────┼──────────────────────┘
│ │ │
│ HTTP POST │ HTTP POST │ HTTP POST
└──────────────────┴──────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────────────┐
│ DOCKER CONTAINER STACK │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Apprise API Gateway (Port 8000) │ │
│ │ • Tag-basiertes Routing │ │
│ │ • Multi-Service Orchestration │ │
│ │ • REST API Endpoint │ │
│ └───┬─────────┬──────────┬──────────┬──────────┬──────────┘ │
│ │ │ │ │ │ │
│ │ ┌──────▼──────┐ ┌─▼────────┐ │ ┌────────▼────┐ ┌───────────┐ │
│ │ │SMS Gateway │ │ WhatsApp │ │ │ Signal │ │ ntfy │ │
│ │ │(Port 3000) │ │ Gateway │ │ │ CLI │ │(Port 8080)│ │
│ │ │ Android │ │ Android │ │ │ REST API │ │ Push │ │
│ │ └──────┬──────┘ └──┬───────┘ │ └─────────────┘ └───────────┘ │
│ │ │ │ │ │
│ ┌───▼─────────▼───────────▼─────────▼─────┐ │
│ │ alarma-network (Bridge) │ │
│ └─────────────────────────────────────────┘ │
│ │ │
└──────────────────────┼───────────────────────────────────────────────┘
│
┌───────────────┼───────────────┐
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 📱 SMS │ │ 💬 WhatsApp│ │ 🔐 Signal │
│ │ │ │ │ │
│ Android │ │ Android │ │ Phone # │
│ Smartphone │ │ Smartphone │ │ +43... │
└─────────────┘ └─────────────┘ └─────────────┘
┌───────────────┬───────────────┐
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 👔 MS Teams │ │ 📧 E-Mail │ │ 🔔 Push │
│ │ │ │ │ │
│ Webhook │ │ SMTP │ │ ntfy │
│ URL │ │ Server │ │ Topics │
└─────────────┘ └─────────────┘ └─────────────┘
KEY FEATURES:
═══════════
• Single API Endpoint für alle Kanäle
• Tag-basiertes Routing (kritisch/warnung/info)
• Android-basierte Gateway-Lösung (SMS/WhatsApp)
• Keine Cloud-Abhängigkeiten
• Vollständig selbst-gehostet- Linux-Server (Ubuntu/Debian)
- Docker & Docker Compose
- Android Smartphone (Android 5.0+)
- Min. 2 GB RAM, 10 GB Speicher
# Repository klonen
git clone https://github.com/walleralexander/alarma.git
cd alarma
# Verzeichnisstruktur erstellen
mkdir -p apprise-config sms-data whatsapp-data signal-data ntfy/{cache,etc}
# Konfiguration anpassen
cp docker-compose.example.yml docker-compose.yml
cp apprise-config/apprise.example.yml apprise-config/apprise.yml
# Bearbeite die Konfigurationsdateien nach deinen Bedürfnissen
# Container starten
docker compose up -d
# Status prüfen
docker compose ps- SMS Gateway App installieren: GitHub Releases
- App konfigurieren mit Server-IP und Token
- WhatsApp Gateway: Web-UI öffnen und QR-Code scannen
PowerShell:
$notification = @{
urls = "tag=kritisch"
title = "Server Alert"
body = "CPU Auslastung kritisch: 95%"
} | ConvertTo-Json
Invoke-RestMethod -Uri "http://notification-server:8000/notify" `
-Method Post -Body $notification -ContentType "application/json"Curl:
curl -X POST http://notification-server:8000/notify \
-H "Content-Type: application/json" \
-d '{
"urls": "tag=kritisch",
"title": "Server Alert",
"body": "CPU Auslastung kritisch: 95%"
}'# Modul importieren
Import-Module .\scripts\NotificationGateway.psm1
# Verwendung
Send-CriticalAlert -Title "Firewall Alert" -Body "Ungewöhnliche Aktivität erkannt"
Send-InfoMessage -Title "Update" -Body "Windows Updates verfügbar"
Send-SMSAlert -Body "Server DC01 nicht erreichbar"- Einmalig: €250 (Android Smartphone)
- Laufend: ~€15/Monat (Mobilfunkvertrag)
- Jahr 1: €430 Gesamtkosten
- Laufend: ~€75/Monat
- Jahr 1: €900 Gesamtkosten
€470 im ersten Jahr, €720 in Folgejahren
Alarma! lässt sich einfach in bestehende Systeme integrieren:
- ✅ PRTG Network Monitor - Sensor-basierte Alerts
- ✅ PowerShell Scripts - Automatisierte Benachrichtigungen
- ✅ Veeam Backup - Backup-Status Reports
- ✅ VMware vCenter - VM-Status Alerts
- ✅ Active Directory - User-Event Notifications
- ✅ MikroTik Router - Script-basierte Alerts
Die vollständige Dokumentation findest du hier:
- Alarma-Dokumentation.md - Komplette Anleitung
- PowerShell-Scripts-README.md - PowerShell Integration
- Docker Compose Beispiele im Repository
| Container | Image | Beschreibung |
|---|---|---|
| apprise-api | lscr.io/linuxserver/apprise-api | Zentrale API & Routing |
| sms-gateway | capcom6/sms-gateway | SMS über Android |
| whatsapp-gateway | dickyermawan/kilas | WhatsApp über Android |
| signal-gateway | bbernhard/signal-cli-rest-api | Signal Messenger |
| ntfy | binwiederhier/ntfy | Push-Notifications |
- Alle Ports nur intern freigeben (LAN/VPN)
- Sichere API-Tokens verwenden
- Optional: HTTPS via Reverse Proxy (nginx/Traefik)
- Rate Limiting implementieren
- Regelmäßige Updates der Container
Verbesserungsvorschläge und Pull Requests sind willkommen!
# Repository forken und klonen
git clone https://github.com/DEIN-USERNAME/alarma.git
# Branch erstellen
git checkout -b feature/neue-funktion
# Änderungen committen
git commit -am "Füge neue Funktion hinzu"
# Push und Pull Request erstellen
git push origin feature/neue-funktionDieses Projekt steht unter der MIT-Lizenz - siehe LICENSE-Datei für Details.
Alexander Waller
WebPoint Internet Solutions
E-Mail: office@webpoint.at
Mit Unterstützung von Claude AI
- Apprise - Multi-Notification-Library
- SMS Gateway - Android SMS Gateway
- signal-cli-rest-api - Signal Integration
- Alle Open-Source-Projekte, die diese Lösung möglich machen
Bei Fragen oder Problemen:
- Prüfe die Dokumentation
- Schau dir die Issues an
- Erstelle ein neues Issue mit detaillierter Beschreibung
Version: 1.0
Letzte Aktualisierung: 29. Januar 2026
⭐ Wenn dir dieses Projekt gefällt, gib ihm einen Stern auf GitHub!