Hilfe-Center / Für Entwickler

Kommandozeilen-Tool (CLI)

Der Befehl pingerer für Ihr Terminal und Ihre CI: installieren, anmelden und die Befehle.

Installieren

Ein kleines Programm für macOS, Linux und Windows, ohne dass Sie sonst etwas installieren müssen. Auf einem Mac oder unter Linux mit Homebrew:

brew install pingerer-app/tap/pingerer

Oder mit dem Installationsskript (macOS und Linux):

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/pingerer-app/pingerer/releases/latest/download/pingerer-installer.sh | sh

Unter Windows, in PowerShell:

powershell -ExecutionPolicy Bypass -c "irm https://github.com/pingerer-app/pingerer/releases/latest/download/pingerer-installer.ps1 | iex"

Oder laden Sie es für Ihren Computer von der Release-Seite herunter. Sie deployen mit GitHub? Die Pingerer-Action öffnet ein Wartungsfenster und prüft, ob Ihre Website wieder da ist, ganz ohne Installation.

Anmelden

Erstellen Sie ein API-Token (API), dann:

pingerer login     # fragt nach dem Token, prüft es und speichert es
pingerer whoami

Das Token wird in ~/.config/pingerer/config.json gespeichert, nur für Sie lesbar. Setzen Sie in CI stattdessen PINGERER_TOKEN. pingerer logout vergisst es wieder.

Konten

pingerer accounts
pingerer use "Your Bakery"        # ab jetzt
pingerer status --account 42      # nur dieses eine Mal

Websites und Überwachungen

pingerer status                                   # endet mit 3, wenn etwas ausgefallen ist
pingerer sites
pingerer sites add yourbakery.com --checks http,ssl,domain --every 1m
pingerer sites show yourbakery.com
pingerer sites pause yourbakery.com
pingerer sites rm yourbakery.com --yes

pingerer monitors --site yourbakery.com
pingerer monitors test mon_8xKq2                  # jetzt eine Prüfung; endet mit 3, wenn sie fehlschlägt
pingerer results mon_8xKq2 --since 24h --failed

Manche Registrys halten Verlängerungsdaten geheim (die meisten in der Golfregion, etwa .kw, .sa und .ae, und einige andere wie .io). Nennen Sie uns Ihres, und wir erinnern Sie rechtzeitig:

pingerer monitors set mon_3Hq7 --renews-on 2027-03-02   # "none" löscht es

Website-Zustand und Link-Vorschauen

Sehen Sie den Zustandswert einer Website und was zu beheben ist, oder prüfen Sie sie jetzt erneut. Beide enden mit 3, wenn es ein kritisches Problem gibt, sodass Sie damit ein Deployment stoppen können.

pingerer health yourbakery.com
pingerer health yourbakery.com --now              # prüft erneut und wartet ein, zwei Minuten
pingerer link-preview yourbakery.com/menu         # wie die Seite beim Teilen aussieht

Störungen

pingerer incidents --open
pingerer incidents show INC-0042
pingerer incidents ack INC-0042
pingerer incidents note INC-0042 Restarted the web server
pingerer incidents resolve INC-0042 -m "Fixed by the host"

Heartbeats

pingerer heartbeats add "Nightly backup" --every 1d --grace 30m
pingerer heartbeats ping "Nightly backup"
pingerer heartbeats ping YOUR-TOKEN --fail        # per Token, keine Anmeldung nötig

Ruhezeiten

Halten Sie Benachrichtigungen, die warten können (SSL, Domain, DNS, E-Mail-Einrichtung und Langsamkeit), über Nacht zurück, und auf Wunsch das ganze Wochenende. Ausfälle und ausgebliebene Heartbeats kommen immer sofort durch.

pingerer quiet-hours
pingerer quiet-hours set --on --from 22:00 --to 07:00 --time-zone Asia/Kuwait --weekends
pingerer quiet-hours set --weekend fri_sat        # oder auto, um nach Ihrer Zeitzone zu gehen

Internetwetter

Liegt es an Ihnen oder an Ihrem Hoster? Sehen Sie, welche Hoster, CDNs und Website-Baukästen gerade Probleme haben. Mit dem Namen eines Unternehmens endet der Befehl mit 3, wenn genau dieses Probleme hat.

pingerer weather
pingerer weather cloudflare

Statusseiten und Wartung

pingerer status-pages list
pingerer status-pages show your-bakery            # mit den Adressen der Abzeichen
pingerer updates post your-bakery --state investigating --title "Checkout errors" \
  --message "We're looking into it." --component "Online shop=partial_outage"
pingerer updates post your-bakery --state resolved --message "Fixed." --follow-up su_8Fk2
pingerer maintenance list

In CI und Skripten

export PINGERER_TOKEN=...   # ein Token mit Lesezugriff reicht
pingerer status || echo "Something is down"

Jeder Befehl kennt --json, --account und --[no-]color (Farbe ist aus, wenn NO_COLOR gesetzt ist). Exit-Codes: 0 alles in Ordnung, 1 ein Fehler, 2 falsche Verwendung, 3 etwas ist ausgefallen. pingerer help und pingerer <command> --help zeigen den Rest.

Kommen Sie nicht weiter? Schreiben Sie uns, ein Mensch antwortet Ihnen.