KumaStatusBar

Your homelab’s status, in the menu bar and on your iPhone.

KumaStatusBar watches Uptime Kuma status pages, your homelab's, your team's or any other page you can reach, one click away on your Mac and a glance away on your iPhone. It tells you the moment something goes down, with no Uptime Kuma login or API key to hand over.

Home and away · Synced across Mac and iPhone · Free, no data collected

Free on the App Store · Mac and iPhone How it works
KumaStatusBar's popover under the menu bar, listing homelab monitors with latency, uptime and heartbeat bars

Built for homelabs

You already run Uptime Kuma. Now keep an eye on it without a browser tab.

Uptime Kuma watches your services. KumaStatusBar watches Uptime Kuma, quietly, from the menu bar, and only gets your attention when something needs it.

At your desk

Glance at the router, the NAS, your self-hosted apps and the internet connection itself, each with latency, 24-hour uptime and its last 30 heartbeats.

When something breaks

A red badge on the menu bar icon, a notification and a sound. A different sound when it recovers, so you know it's fixed without looking.

Away from home

Direct to Uptime Kuma on your network, through your Cloudflare Tunnel everywhere else. It switches on its own when you leave the house.

Alerts

Know the moment something goes down

Problems jump to the top of the list, so the one thing that's wrong is the first thing you see.

Down Pending or unreachable Maintenance
  • Choose any built-in macOS sound for down and for recovered.
  • Sounds play even with Focus on, for alerts you can't miss (or switch them off).
  • Simulate status changes lets you see and hear it all without breaking anything.
The popover showing a Media server monitor down in red at the top of the list, with a red dot on the menu bar icon

Home and away

Direct at home. Through your tunnel when away.

Give KumaStatusBar two addresses and it picks the right one. A small badge in the popover shows which it used: Home or Remote.

  • Works on Wi-Fi, Ethernet and over a VPN back home, with no Wi-Fi network names to configure.
  • Plain http:// on your LAN is fine, and self-signed certificates can be trusted.
  • Cloudflare Access service tokens are kept in your Keychain and only ever sent to the remote URL.
The popover with a Home badge on the home network and a Remote badge elsewhere

Ideas

What homelabbers watch with it

Anything Uptime Kuma can monitor and you've put on a status page shows up here. A few favourites:

🌐
Your internet connectionPing a public resolver over IPv4 and IPv6 to see outages before the family does.
🗄️
NAS and backupsA push monitor from your backup job turns a silent failure into a red badge.
🏠
Home automationKnow when the hub that runs the lights stops answering.
🎬
Media and self-hosted appsMedia server, photo library, password manager, wiki: the apps people notice first.
🔐
Certificates and DNSCatch an expiring certificate or a broken DNS record before visitors do.
🖥️
Hypervisors and Docker hostsGroup monitors keep a whole host to one tidy line.

Setup

Up and running in a few minutes

KumaStatusBar reads your status page, public or behind Cloudflare Access, so there's no Uptime Kuma password or API key to hand over.

Make a status page

In Uptime Kuma, create a status page and add the monitors you want in your menu bar. Use groups to keep it tidy; KumaStatusBar shows them the same way.

Optional: reach it from anywhere

Publish Uptime Kuma through a Cloudflare Tunnel. To keep it private, protect it with Cloudflare Access and create a service token with a Service Auth policy.

Paste the addresses

In KumaStatusBar's Settings, paste your status page's home address (e.g. http://192.168.1.20:3001/status/home) and its remote one, add the token if you have one, and click Test.

On your iPhone

The same status page, in your pocket

KumaStatusBar for iPhone shows your monitors with their latency, uptime and heartbeats, uses your home address on Wi-Fi and your remote one everywhere else, and puts your status on the Home Screen and Lock Screen.

  • Widgets show what's up and what's down, and check in on their own throughout the day.
  • Set up once: your addresses and Cloudflare token sync between Mac and iPhone through iCloud, or scan a QR code from Share Setup.
  • For instant push alerts on your phone, pair it with Uptime Kuma's own notifications (ntfy, Pushover, Bark).
KumaStatusBar on iPhone, listing homelab monitors by group with latency, uptime and heartbeat bars KumaStatusBar widgets on an iPhone Lock Screen and Home Screen, one showing a Media server outage

Features

Small, focused, and private

Groups, heartbeats and uptimeThe same view as your status page, sorted with problems first, and it scrolls when the list gets long.
Status at a glanceA monochrome menu bar icon with a green dot when all is well, and red, yellow or blue when something needs attention.
Automatic home or remoteTries your home address first, falls back to remote, re-checks when the network changes.
Cloudflare Access supportService tokens in the Keychain, sent only to your remote address.
Distinct alert soundsOne for down, one for recovered, from the built-in macOS sounds.
Testing toolsTry a built-in demo homelab, simulate an outage, or preview pages of 1 to 60 monitors.
No data collectedNo accounts, analytics or tracking. It only talks to the addresses you enter.
iPhone app and widgetsThe status page on iPhone, with Home Screen and Lock Screen widgets.
Set up onceSettings and token sync between Mac and iPhone through iCloud, or share a QR code.
Fits inLight and dark mode, launch at login, a standard Settings window. Mac with Apple silicon and macOS 14 or later; iPhone with iOS 17 or later.

Questions

FAQ

Does it need my Uptime Kuma login or an API key?

No. It reads the status page you'd open in a browser, so it only sees what's on that page, and it can't change anything on the server. Unlike Uptime Kuma management apps, it never logs in.

Can I watch a status page I don't run?

Yes, if you can open it in a browser: a team's or provider's Uptime Kuma status page works the same as your own. If it's behind Cloudflare Access, you'll need a service token from whoever runs it.

How is this different from Uptime Kuma manager apps?

Manager apps log in to Uptime Kuma to add and change monitors. KumaStatusBar doesn't: it watches your status pages, so there's no admin access to hand over. It's built for checking in from anywhere: direct at home, through your tunnel when away, in the Mac menu bar and on iPhone with your settings synced, for free and without collecting any data.

Can I watch more than one status page?

Not yet: KumaStatusBar watches one status page, with separate home and remote addresses for it. Watching several pages at once is planned.

Can I keep my status page private?

Yes. Put it behind Cloudflare Access and give KumaStatusBar a service token. On your home network it can connect to Uptime Kuma directly, with no token involved.

Do I need Cloudflare?

No. Any address that reaches your Uptime Kuma server works, such as a reverse proxy or a VPN. Cloudflare Access support is there if you use it.

Does it work over Ethernet and VPNs?

Yes. It decides by whether your home address answers, not by Wi-Fi network name, so wired connections and VPNs home work too.

What does it cost?

Nothing. KumaStatusBar is free on the App Store, for Mac and iPhone, with no in-app purchases.

Is there an iPhone version?

Yes, with widgets. It's the same App Store download as the Mac app. iOS only lets apps check while they're open (and widgets every 15–30 minutes), so for instant alerts on your phone, use Uptime Kuma's own notifications alongside it.

What does it collect?

Nothing. See the privacy policy.