Knockbox
One curl, your phone buzzes.
Knockbox is an iPhone and iPad app that turns a single HTTP request into a push notification on your phone. Anything that can send a request can reach you: a deploy script, a cron job, a monitoring check, a CI pipeline, or a coding agent that has just finished a long task. It is the client for a server you control, and that server is open source.
What it does
- Devices
- iPhone · iPad
- Platform
- iOS 17 or later
- Category
- Developer Tools
- Price
- Free
- Languages
- English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Português
- Data collected
- None
- Developer
- miramiao
- Bundle ID
com.miramiao.knockbox
Knockbox is for the things that need to tell you they are done: a deploy that finished, a cron job that failed, a disk filling up, a broken build, an agent that just completed a long task. What they have in common is one HTTP request — not a platform to sign up for. The server is open source and runs on a VPS, a NAS or a Raspberry Pi at home. It holds its own Apple push key, so a notification goes from your machine to Apple and then to your phone, without passing through anyone in between. If you would rather not run anything, pair with the public instance we operate at knockbox.miramiao.com by scanning its QR code.
- One request is enough. curl -d "Build finished" https://your-server/api/v1/send/TOKEN — anything that speaks HTTP can reach your phone, GET and form posts included.
- The server is yours. Open source, running on a VPS, a NAS or a Raspberry Pi at home. It holds its own Apple push key, so notifications go from your machine to Apple to your phone, with nobody in between. Or use the public instance we run at knockbox.miramiao.com.
- No length limit on the body. The body is fetched as the notification lands rather than packed into it. Markdown headings, lists, links and syntax-highlighted code all survive.
- Images arrive in the notification. They stay with the message too, instead of sending you off to a web page.
- A channel per thing. One token per channel, so a noisy monitor and a personal reminder stay apart. A leaked token is rotated in channel settings; the history is untouched.
- Muting happens on the server. The mute lives on the server, so nothing is sent at all — it is not delivered and then suppressed.
- You set the interruption level. Quiet, normal, or time sensitive when it has to break through Focus.
- Another device is one scan away. Pair a second iPhone or iPad from a device that is already connected. Both receive everything and share read state.
Screenshots
Pricing
Free
Free. No ads, no analytics, no account with us, no in-app purchase and no subscription. The server is open source and you run it.
Questions
Do I have to run my own server?
No. We run a public instance at knockbox.miramiao.com — scan its QR code and you are going. If you would rather control everything, the server is open source and runs on a VPS, a NAS or a Raspberry Pi.
Who holds the push key?
You do, when you self-host. The server has its own Apple push key, so a notification goes from your machine to Apple and then to your phone.
Is it free?
The app is free — no in-app purchases, no subscription, no ads. The server is open source.
How long can a message be?
There is no length limit to work around. The body is fetched as the notification lands rather than packed into it, so long text and code come through.
How many devices can I use?
Pair a second iPhone or iPad by scanning from a device that is already connected. Both receive everything and share read state.
Are deletions real?
Yes. Deleting a message or clearing a channel removes it on the device and on the server.
