Knockbox – Self-Hosted Push
One curl, one notification
Free
Anything that can send an HTTP request can reach your phone: a deploy script, a cron job, a coding agent. No server? Open knockbox.miramiao.com on your iPhone.
Knock once, and your phone buzzes.
Knockbox turns one HTTP request into a push notification on your iPhone. 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. If it needs your go-ahead before continuing, it can wait for your answer.
curl -d "Build finished" https://your-server/api/v1/send/YOUR_TOKEN
THE SERVER IS YOURS
Knockbox is the client for a server you control. 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, open knockbox.miramiao.com on your iPhone and you are connected — no sign-up, no password.
WHAT A MESSAGE CAN CARRY
• A Markdown body with headings, lists, links and syntax-highlighted code.
• Images, shown in the notification and kept with the message.
• Long text. The body is fetched as the notification lands rather than packed into it, so there is no length limit to work around.
• A title, a channel, and an interruption level: quiet, normal, or time sensitive when it has to break through Focus.
REPLIES
• The sender can attach a set of options, or allow a free-text answer.
• Answer from the message itself. Your server posts the reply back to the address the sender gave, signed, and the sender takes it from there.
• The sender can set a deadline. After it passes the message reads "Reply window closed" and the server stops accepting — you are never left thinking an answer went through.
• A message is answered once, and the answer is the same across your devices.
CHANNELS
• One token per channel, so a noisy monitor and a personal reminder stay apart.
• Muting a channel truly stops it: the mute lives on the server, so nothing is sent at all.
• Search your history, mark as read, delete a message, or clear a channel. Deletions are real, on the device and on the server.
MORE THAN ONE DEVICE
Pair a second iPhone or iPad from a device that is already connected. Both receive everything and share read state.
TRY IT WITHOUT A SERVER
Demo mode fills the app with example messages and sends a sample notification, so you can see how it works before setting anything up.
FREE, AND THAT IS ALL
No ads, no analytics, no account with us, no in-app purchase, no subscription. The app is free and the server is open source.
Server source code: https://github.com/aichy126/knockbox
Public server: https://knockbox.miramiao.com
How to send: https://knockbox.miramiao.com/docs
Questions: info@miramiao.com
Ratings & Reviews
- This app hasn’t received enough ratings or reviews to display an overview.
The first screen is no longer just a QR scanner.
It now asks where your messages should come from: run your own server (it is open source and
starts with one docker command), or connect to our public server instead (open
knockbox.miramiao.com — no sign-up, no password).
• Setup instructions and the server source code open straight from the first screen and from Settings.
• Settings › Server now links to "How to send", pointing at your own server's guide.
• You can switch from demo mode to a real server without leaving the demo first.
Also fixes several known issues.
The developer, 苗 苗, indicated that the app’s privacy practices may include handling of data as described below. For more information, see the developer’s privacy policy .
Data Linked to You
The following data may be collected and linked to your identity:
- User Content
- Identifiers
- Diagnostics
Accessibility
The developer has not yet indicated which accessibility features this app supports. Learn More
Information
- Seller
- 苗 苗
- Size
- 7.6 MB
- Category
- Developer Tools
- Compatibility
Requires iOS 17.0 or later.
- iPhone
Requires iOS 17.0 or later. - iPad
Requires iPadOS 17.0 or later.
- iPhone
- Languages
English and 6 more
- English, Japanese, Korean, Portuguese, Simplified Chinese, Spanish, Traditional Chinese
- Age Rating
4+
- 4+
- Copyright
- © 2026 miao miao