w wokku
Get Started
~/docs
/
monitoring

Uptime & Incidents

Wokku checks your app every minute, opens an incident when it goes down, and tells you — mute push alerts when you need quiet.

Updated 2026-11-07 · Edit on GitHub ↗

You’ll see how uptime checks work, look up incidents, and mute alerts on your phone. Uptime checks are on for every running app that has a domain — nothing to enable.

How uptime checks work

  • Every minute Wokku requests https://<your-domain>/ (your app’s first domain, e.g. my-app.wokku.app).
  • Up = any answer below HTTP 500. A 404 still means your app is alive.
  • Down = 3 failed checks in a row. Wokku opens an incident and sends an app_down notification.
  • The first successful check closes the incident and sends app_recovered.
  • Free apps that sleep when idle are not checked, so checks don’t keep them awake.

Each incident records a reason:

Reason Meaning
host_down Our host is unreachable — not your code; we’re on it
app_stopped The app is stopped
app_crashed The container crashed — check wokku logs my-app
http_5xx The app answers with server errors
timeout The app doesn’t answer in time
connection_refused Nothing is listening on the app’s port
dns_error The domain doesn’t resolve
ssl_error The SSL certificate fails the handshake

Platform-wide status is public at status.wokku.cloud.

List incidents

bash
wokku incidents                  # open incidents
wokku incidents --all            # recent ones, resolved too
wokku incidents --app my-app     # one app
wokku incidents:info INCIDENT_ID # reason, start, end, duration

Mute push alerts

Mutes silence push alerts on your phone only, for you only. Email, Slack, Discord, Telegram and webhook alerts keep going to the whole team.

Mute an app, an event, or both — optionally for a while. Without a time limit, the mute lasts until you remove it.

bash
wokku alerts:mute --app my-app --for 8h       # all events for my-app, 8 hours
wokku alerts:mute --event deploy_succeeded    # one event, every app
wokku alerts:mutes                            # list active mutes
wokku alerts:unmute MUTE_ID

--for takes minutes, hours or days: 30m, 8h, 1d.

Events you can mute: deploy_succeeded, deploy_failed, app_crashed, backup_completed, backup_failed, resource_high_cpu, resource_high_memory, app_down, app_recovered.

Note

Push alerts need the Wokku iOS & Mac app. See iOS & Mac App.

See also

Was this page helpful?