Betreiben Sie ihn auf einem eigenen Gerät, das eingeschaltet bleibt: einem Raspberry Pi, einem NAS, einem Linux-Computer mit Docker oder Home Assistant. Er überwacht Ihr Netzwerk kostenlos, sendet seine Meldungen an Ihre eigenen Dienste und meldet Ihrem iPhone mit Guardian, wenn das Internet ausfällt, ein neues Gerät hinzukommt oder ein Gerät offline geht.
PingKit fürs iPhone ladenKostenlos, mit kostenlosen Meldungen an ntfy, Telegram, Discord, Pushover oder einen Webhook. Meldungen auf Ihrem iPhone erfordern Guardian: 2,99 € im Monat oder 29,99 € im Jahr auf dem iPhone, mit 1 Woche kostenlosem Test.
Ein Raspberry Pi 4 oder 5 mit 64-Bit-Raspberry-Pi-OS. Ein Befehl installiert ihn; die Anleitung für den Raspberry Pi führt durch die erste Stunde und den ersten Tag.
Eine Home-Assistant-App für aarch64 und amd64. Mit dem Mosquitto-Broker bringt sie Ihr Netzwerk in Home Assistant, ohne dass Sie etwas eintippen.
Container Manager mit der Compose-Datei für Synology, die ihre eigene Anleitung mitbringt.
QNAP, TrueNAS SCALE, OpenMediaVault, CasaOS, Portainer und Unraid haben jeweils eine eigene Compose-Datei oder Vorlage.
Jeder 64-Bit-Linux-Computer mit Docker: eine compose.yaml und docker compose up -d.
PingKit Agent für Docker und Raspberry Pi ist ein kleines Programm, das Sie auf einem eigenen Gerät betreiben, das eingeschaltet bleibt. Er überwacht Ihr eigenes Netzwerk, solange dieses Gerät eingeschaltet bleibt:
Er beobachtet; er sperrt keine Geräte und ändert nichts in Ihrem Netzwerk. Er braucht keinen Mac. Wenn Sie einen Mac haben, der wach bleibt, erledigt der Mac Agent dieselbe Aufgabe über die Menüleiste und liefert zusätzlich WLAN-Messwerte.
Alles, was der Agent in Ihrem eigenen Netzwerk tut, ist kostenlos, mit oder ohne iPhone:
apprise-api für alles andere, mit Ereignisfiltern und Ruhezeiten pro Ziel;Kein iPhone? Lassen Sie den Kopplungscode leer. Der Agent überwacht trotzdem, zeigt seine Seiten und sendet an Ihre eigenen Dienste.
Das Koppeln eines iPhone, der Status des Agents und die letzten 24 Stunden seiner Zeitleiste sind kostenlos. PingKit Guardian ergänzt die Weiterleitung und das Dashboard:
Bezahlt wird die Weiterleitung und das Dashboard, und das finanziert die eine Person, die PingKit entwickelt.
Öffnen Sie zuerst PingKit auf Ihrem iPhone, gehen Sie zu Agents, tippen Sie auf „Agent hinzufügen“ und notieren Sie den 8-stelligen Code. Der Code funktioniert einmal, 10 Minuten lang. Kein iPhone? Lassen Sie den Code leer. Wählen Sie dann das Gerät, auf dem er laufen soll.
Speichern Sie dies als compose.yaml, setzen Sie Ihren Code zwischen die Anführungszeichen und führen Sie docker compose up -d.
services:
pingkit-agent:
image: ghcr.io/pingkit/agent:1
restart: unless-stopped
stop_grace_period: 20s
network_mode: host
read_only: true
cap_drop: [ALL]
user: "65532:65532"
security_opt: [no-new-privileges:true]
tmpfs: [/tmp:rw,noexec,nosuid,nodev,size=16m]
mem_limit: 256m
pids_limit: 64
volumes: [pingkit-agent-data:/data]
environment:
PINGKIT_CLAIM_CODE: "" # der Code von Ihrem iPhone, einmal verwendet
# PINGKIT_NOTIFY_URLS: "ntfy://192.168.1.5/home-net" # Meldungen an Ihre eigenen Dienste
volumes:
pingkit-agent-data:
stop_grace_period: 20s steht dort, weil der Agent innerhalb von 15 Sekunden nach dem Stoppsignal sauber herunterfährt und die Docker-Voreinstellung von 10 Sekunden das abschneiden würde.
Für Synology, QNAP, TrueNAS SCALE, OpenMediaVault, CasaOS, Portainer und Unraid nutzen Sie die passende Datei im compose-Ordner auf GitHub; jede enthält ihre eigene Anleitung. Der Agent braucht das Netzwerk des Hosts (network_mode: host), um Ihre Geräte zu sehen, deshalb wird Docker Desktop unter Windows und macOS nicht unterstützt.
Das Tag :1 wandert mit jedem neuen 1.x-Release mit. Um genau einen signierten Build zu betreiben, laden Sie ihn stattdessen über seinen Digest, den die Release Notes des jeweiligen Release nennen: docker pull ghcr.io/pingkit/agent:1.0.0@sha256:<digest>.
Unter 64-Bit-Raspberry Pi OS auf einem Raspberry Pi 4 oder 5:
curl -fsSL https://pingkit.app/agent/install.sh | sudo sh -s -- --claim-code YOURCODE
Das Skript prüft die SHA-256-Prüfsumme des Downloads gegen den darin hinterlegten Wert, bevor irgendetwas läuft, richtet einen Dienst ein, der unter einem eigenen Benutzer ohne Sonderrechte läuft, und zeigt die Adresse der Statusseite an. Führen Sie es mit --update erneut aus, um zu aktualisieren, oder mit --uninstall, um den Agent zu entfernen. Sie können das Skript lesen, bevor Sie es ausführen. Die Raspberry-Pi-Anleitung führt durch die erste Stunde, den ersten Tag, Pi-hole und die Fehlersuche.
Tippen Sie auf die Schaltfläche unten, oder öffnen Sie in den Einstellungen Apps, dann App installieren, und fügen Sie unter Repositories, im Menü oben rechts, https://github.com/pingkit/ha-apps hinzu. Installieren Sie PingKit Agent, fügen Sie Ihren Code unter Claim code ein und starten Sie ihn. Vor Home Assistant 2026.2 hießen Apps Add-ons. Die App läuft auf aarch64 und amd64, ein Raspberry Pi braucht also das 64-Bit-Image von Home Assistant OS. Die Seite zu Home Assistant behandelt Entitäten, Anwesenheit und die Seitenleiste.
Repository zu Ihrem Home Assistant hinzufügen
Ihr iPhone listet den Agent innerhalb einer Minute unter Agents. Die Statusseite des Agents unter http://<Adresse des Geräts>:7474/ zeigt die Kopplung, das überwachte Netzwerk, den letzten Durchlauf und das Ausfallprotokoll.
Ping ist optional. Ohne Ping prüft der Agent Geräte über ARP und TCP-Verbindungsversuche. Unter Docker erlauben Sie Ping auf dem Host mit sudo sysctl -w net.ipv4.ping_group_range="65532 65532"; eine Container-Berechtigung hilft nicht, denn der Agent öffnet ausschließlich Datagramm-Ping-Sockets, die allein diese Einstellung zulässt. Das Raspberry-Pi-Skript richtet sie für Sie ein.
Unter TrueNAS SCALE fügen Sie die Einstellung unter System, Advanced Settings, Sysctl hinzu: Variable net.ipv4.ping_group_range, Wert 0 2147483647. TrueNAS behält sie nach einem Neustart, und dieser Bereich deckt die Gruppe der Compose-Datei ebenso ab wie die der TrueNAS-App. In einem unprivilegierten Proxmox-Container (LXC) setzen Sie sie im Container selbst, als root: sysctl -w net.ipv4.ping_group_range="65532 65532", und schreiben dieselbe Zeile, ohne sysctl -w, in /etc/sysctl.d/60-pingkit-agent.conf, damit sie einen Neustart des Containers übersteht. Der Container lehnt 0 2147483647 ab, und eine Einstellung auf dem Proxmox-Host erreicht ihn nicht, weil jeder Container eigene Netzwerkeinstellungen hat. Ohne die Einstellung funktioniert der Agent auf beiden weiterhin und prüft stattdessen per TCP.
Aktualisieren: docker compose pull && docker compose up -d unter Docker, der Installationsbefehl erneut mit --update auf einem Raspberry Pi und der App-Store in Home Assistant.
Sobald er gekoppelt ist, führt der Agent einmal am Tag einen Geschwindigkeitstest gegen den Messpunkt von PingKit aus, jeden Tag zu einer neuen zufälligen Minute, sodass ein Monat an Tests jede Stunde abdeckt. Während eines Ausfalls läuft nie ein Test. Bei einem Anschluss mit Datenvolumen setzen Sie PINGKIT_SPEED_TEST zu manual, dann läuft ein Test nur, wenn Sie ihn anfordern, oder auf off. PINGKIT_SPEED_BUDGET_MB ist die größte Datenmenge, die die Tests in einem Kalendermonat übertragen dürfen, 10.000 MB, solange Sie nichts ändern.
Ein Test über WLAN oder einer, der 90 % der eigenen Verbindung des Agents erreicht, wird gespeichert und als durch diesen Monitor begrenzt gekennzeichnet, weil er das Gerät gemessen hat und nicht Ihre Leitung. Die Ergebnisse auf Ihrem iPhone gehören zum Dashboard von Guardian.
Der Agent selbst ist kostenlos, mit oder ohne iPhone. Bezahlt wird die Weiterleitung und das Dashboard auf Ihrem iPhone, und das finanziert die eine Person, die PingKit entwickelt.
| Kostenlos | PingKit Guardian | Guardian Plus | |
|---|---|---|---|
| Der Agent, seine Seiten, Meldungen an Ihre eigenen Dienste (Webhook, ntfy, Telegram, Discord, Pushover, apprise-api), Home-Assistant-Entitäten über MQTT | Ja | Ja | Ja |
| Ein iPhone koppeln, den Zustand des Agents sehen | Ja | Ja | Ja |
| Die Zeitleiste des Agents auf Ihrem iPhone | Die letzten 24 Stunden | Ja | Ja |
| Angezeigter Verlauf, auf dem iPhone und auf den Seiten des Agents (der Agent speichert in jedem Fall ein Jahr) | 30 Tage auf den Seiten des Agents | 90 Tage | 365 Tage |
| Push-Meldungen auf Ihr iPhone für jede Art von Meldung, die Live-Aktivität, das Widget, Kontrollzentrum, Siri | Ja | Ja | |
| Das Dashboard: Geräte, Ausfälle, Verlust und Latenz, Geschwindigkeitstests, Wake-on-LAN und weitere Aktionen vom iPhone aus | Ja | Ja | |
| Der Internet-Ausfallbericht für Ihren Anbieter | Ja | Ja | |
| Agents | 1 | 1 | Bis zu 5 |
| Telefone pro Agent | 1 | 1 | Bis zu 5 |
Preise im deutschen App Store, jedes Abo mit 1 Woche kostenlosem Test:
| Auf dem iPhone | Auf dem Mac | |
|---|---|---|
| PingKit Guardian | 2,99 € im Monat oder 29,99 € im Jahr | 2,99 € im Monat oder 29,99 € im Jahr |
| Guardian Plus | 9,99 € im Monat oder 89,99 € im Jahr | 5,99 € im Monat oder 44,99 € im Jahr |
Ein Abo, das auf einem der beiden Geräte gekauft wurde, gilt auf beiden, und die höhere Stufe gewinnt.
Die vollständige Liste. Eine Prüfung bei jedem Build hält den Quellcode des Agents an diese Liste, damit kein neues Ziel unbemerkt hinzukommt.
| Ziel | Was und wann |
|---|---|
Der Server von PingKit, monitor.pingkit.app | Kopplung (der Kopplungscode und ob er in Docker, auf einem Raspberry Pi, in Home Assistant oder anderswo läuft, und sein CPU-Typ). Alle fünf Minuten ein Lebenszeichen: die Version des Agents, wie lange er läuft, ob seine Internetprüfung bestanden hat und wie viele Geräte online sind, eine Zahl und nie ein Name. Meldungsereignisse, die zum Push-Dienst von Apple für Ihr iPhone weitergereicht und nicht gespeichert werden: PingKit behält die Art des Ereignisses, wie viele und wann. Mit der Weiterleitung eine Verbindung, die Befehle von Ihrem iPhone überträgt, signiert von Ihrem iPhone, und ihre versiegelten Antworten. |
Der Messpunkt für Geschwindigkeitstests von PingKit, speed.pingkit.app | Der Datenverkehr des täglichen Geschwindigkeitstests, sofern Sie ihn nicht ausschalten. |
pingkit.app/agent/latest.json | Die Nummer der neuesten Version und ihre Signatur, damit Sie erfahren, dass es ein Update gibt. |
Die Internetprüfung: 1.1.1.1, 8.8.8.8, 9.9.9.9 | Ein Ping oder ein Verbindungsversuch; eine DNS-Anfrage nach dem Namen des PingKit-Servers, gestellt an Ihren Router und an 1.1.1.1; einmal pro Stunde eine kurzlebige Probe in Richtung 1.1.1.1, die den ersten Knoten hinter Ihrem Router findet. Häufiger, während etwas nicht stimmt. |
| Ihre eigenen Dienste | Nur die Benachrichtigungsziele und der MQTT-Broker, die Sie einrichten, und in Home Assistant dessen eigener Supervisor. |
| Ihr eigenes Netzwerk | Erkennungsanfragen, Pings und Verbindungsversuche zu Geräten in Ihrem eigenen Netzwerk. |
Sonst nichts. Der Push-Dienst von Apple wird nur über den Server von PingKit erreicht. Ihre Geräteliste bleibt auf dem Agent: Ihr iPhone liest sie direkt, in Ihrem Netzwerk oder über ein VPN, das in Ihr Netzwerk führt, über eine verschlüsselte Verbindung, die beide beim Koppeln einrichten. Eine Meldung kann das Gerät, um das es geht, auf dem Weg zu Ihrem iPhone nennen, aber Gerätenamen werden nie auf den Servern von PingKit gespeichert. Es gibt kein Konto. Die Einzelheiten stehen in der Datenschutzerklärung.
| PingKit Agent für den Mac | PingKit Agent für Docker und Raspberry Pi | |
|---|---|---|
| Läuft auf | Ein Mac mit macOS 15 oder neuer | Ein Linux-Computer mit Docker, ein NAS, ein Raspberry Pi 4 oder 5 mit 64 Bit oder Home Assistant |
| Überwacht Ihr Netzwerk | Solange der Mac wach ist | Solange das Gerät eingeschaltet bleibt |
| Meldungen auf Ihrem iPhone | Mit Guardian | Mit Guardian |
| Ihre Geräteliste | In Ihrem privaten iCloud | Auf dem Gerät; Ihr iPhone liest sie direkt |
| WLAN-Messwerte, Sicherheitsscan | Ja | Nein |
Ehrlich und datiert; prüfen Sie die Seiten jedes Projekts selbst, bevor Sie sich entscheiden.
| PingKit Agent | Fing Agent | NetAlertX | WatchYourLAN | |
|---|---|---|---|---|
| Kosten im Betrieb | Kostenlos | Ein bezahltes Fing-Abo: Premium 8,99 US-Dollar im Monat oder 79,99 US-Dollar im Jahr auf fing.com, 7,99 oder 69,99 US-Dollar in der iPhone-App von Fing | Kostenlos | Kostenlos |
| Quelle | Geschlossener Agent; lokale API, MQTT und Webhooks | Geschlossen | Offen (GPL-3.0) | Offen (MIT) |
| Meldungen an Ihre eigenen Dienste | ntfy, Telegram, Discord, Pushover, Webhook, apprise-api, kostenlos | Auf seiner Agent-Seite nicht genannt | Apprise, Pushover, ntfy, Webhooks | Shoutrrr |
| Eine native iPhone-App mit Push | Ja, mit Guardian | Ja, in der Fing-App | Nein, eine Browser-Oberfläche | Nein, eine Browser-Oberfläche |
| Home Assistant | Home-Assistant-App, Entitäten über MQTT | Offizielle Integration (Local Polling) | Ein Home-Assistant-Add-on in einem Community-Repository | In seiner README nicht erwähnt |
| Rechte in der Beispielkonfiguration | Nur das Netzwerk des Hosts, keine zusätzlichen Capabilities | Nicht angegeben | Host-Netzwerk plus NET_RAW, NET_ADMIN, NET_BIND_SERVICE | Host-Netzwerk |
| 32-Bit-Raspberry-Pi | Nein, nur 64 Bit | Nein, sein Docker-Image ist 64 Bit | Ja (armv6, armv7) | Ja (arm_v6, arm_v7) |
Fing Agent so, wie fing.com/agent und fing.com/pricing ihn beschreiben, und die iPhone-App von Fing so, wie ihr App-Store-Eintrag sie zeigt; NetAlertX und WatchYourLAN so, wie ihre eigenen READMEs und Dokumentationen sie beschreiben. Alles geprüft am 11. November 2026. NetAlertX kann in einem LAN weit mehr als PingKit (Plugins, Router-Importe, eine vollständige Weboberfläche); wenn Sie Open Source und eine vollständige Weboberfläche wollen, ist es das Projekt, das Sie sich ansehen sollten. Fing Agent kann Geräte sperren und Zugriffszeiten festlegen; PingKit Agent kann das nicht. Im direkten Vergleich: PingKit Agent vs NetAlertX (auf Englisch) und PingKit Agent vs Fing Agent.
Der Agent nutzt das Netzwerk des Hosts, das eine Recht, das er braucht, um die Nachbartabelle (ARP) zu lesen und die Bonjour- (mDNS) und UPnP-Ankündigungen (SSDP) Ihrer Geräte zu hören; ein Bridge-Netzwerk verbirgt alle drei. Jede Probe ist ein Verbindungsversuch, ein Ping oder eine Erkennungsanfrage an Geräte in Ihrem eigenen Netzwerk, dazu die Internetprüfungen aus der Tabelle oben. Er läuft als Benutzer ohne Root-Rechte, ohne zusätzliche Capabilities und mit schreibgeschütztem Dateisystem, und er öffnet nie einen Raw-Socket.
Die Images sind über eine GitHub-Anmeldung mit cosign signiert; der Aussteller für die Prüfung lautet https://github.com/login/oauth. Die Release Notes jedes Release auf GitHub nennen die in der Signatur hinterlegte E-Mail-Adresse, den Digest, den Befehl, der ihn prüft, und eine Software-Stückliste (SBOM).
Unsere Zusage zur Fortführung, geschrieben am 10. November 2026: Der Agent arbeitet in Ihrem Netzwerk auch ohne den Server von PingKit weiter, einschließlich seiner Seiten, seiner Meldungen an Ihre eigenen Dienste und seiner Home-Assistant-Entitäten. Sollte es PingKit einmal nicht mehr geben, entfernt ein letzter Build die Abhängigkeit vom Server von PingKit, sodass der Agent, den Sie betreiben, weiterläuft.
Nur 64 Bit: ein Linux-Computer oder NAS mit amd64 oder arm64 oder ein Raspberry Pi 4 oder 5 mit 64-Bit-Raspberry Pi OS. Das Raspberry-Pi-Skript lehnt ein 32-Bit-System ab.
Docker Desktop unter Windows und macOS kann dem Agent Ihre Geräte nicht zeigen, weil sein Host-Netzwerk nicht bis zu ihnen reicht. Nutzen Sie einen Linux-Host.
Keine WLAN-Messwerte, kein Sicherheitsscan und keine Uptime-Watch-Ziele. Er überwacht Geräte und das Internet, und er überwacht nur, solange sein Gerät eingeschaltet bleibt.
Ein Gerät wird nach drei verpassten Durchläufen als offline gemeldet, in der Standardeinstellung nach bis zu 45 Minuten.
Das Image ist auf arm64 etwa 41 MB und auf amd64 etwa 43 MB groß. In einem 24-Stunden-Test auf einer virtuellen Linux-Maschine belegte der Agent höchstens etwa 55 MB Arbeitsspeicher und weniger als 1 % eines Kerns. Auf einem Raspberry Pi haben wir ihn noch nicht gemessen.
Nein. Sie koppeln ihn mit dem 8-stelligen Code, den PingKit auf Ihrem iPhone unter Agents anzeigt; er gilt einmal und 10 Minuten lang. Ein PingKit-Konto gibt es nicht.
Auf einem Raspberry Pi 4 oder 5 mit 64-Bit-Raspberry Pi OS. Das Installationsskript lehnt ein 32-Bit-System ab.
Nein. Der Agent braucht das Netzwerk des Hosts, um Ihre Geräte zu sehen, und Docker Desktop unter Windows und macOS gibt einem Container dieses nicht. Betreiben Sie ihn auf einem Linux-Computer, einem NAS oder einem Raspberry Pi. Auf einem Mac nutzen Sie stattdessen den Mac Agent.
Ihr iPhone liest die Geräteliste direkt vom Agent, deshalb muss es in Ihrem Netzwerk sein oder über ein VPN verbunden, das in Ihr Netzwerk führt. Meldungen kommen als gewöhnliche Mitteilungen an, über WLAN oder Mobilfunk.
Ja. Lassen Sie den Kopplungscode leer, dann überwacht der Agent Ihr Netzwerk trotzdem, zeigt seine eigenen Seiten und sendet seine Meldungen an ntfy, Telegram, Discord, Pushover, einen Webhook oder apprise-api sowie über MQTT an Home Assistant. All das ist kostenlos.
Der Agent selbst ist kostenlos, ebenso seine eigenen Seiten mit 30 Tagen Verlauf, seine Meldungen an Ihre eigenen Dienste und seine Home-Assistant-Entitäten. Auf Ihrem iPhone sind das Koppeln eines Agents, der Status des Agents und die letzten 24 Stunden seiner Zeitleiste kostenlos. Push-Meldungen von Ihrem Agent, das Dashboard mit Geräteliste und Ausfallprotokoll des Agents, 90 Tage Verlauf und der Internet-Ausfallbericht erfordern PingKit Guardian. 365 Tage Verlauf und mehr als ein Agent, bis zu fünf, erfordern Guardian Plus.
Laden Sie PingKit, öffnen Sie Agents und tippen Sie auf „Agent hinzufügen“, um Ihren Code zu erhalten. Der Agent selbst ist kostenlos.
Kostenlos im App Store ladenErfordert iOS 17.0 oder neuer und PingKit 4.0 oder neuer. Der Agent und seine lokalen Meldungen sind kostenlos; Meldungen von Ihrem Agent auf Ihrem iPhone erfordern Guardian.