Knockbox — Support

Getting started

Knockbox needs a server to receive messages. There are two ways to get one:

Use the public instance. Open knockbox.miramiao.com and scan the QR code with Knockbox. There is no sign-up and no password. If you are reading this on the iPhone itself, the “Open on this iPhone” link on that page connects the app directly.
Run your own. The server is open source under the MIT license. Source code, binaries for every platform and Docker images are at github.com/aichy126/knockbox. Self-hosting means the messages never leave your hardware.

Once connected, that page hands you a send page of your own, with a worked example of every format and a button that sends one for real.

Contact

Email info@miramiao.com.

Frequently asked

What is this for?

Sending yourself a notification from anything that can make an HTTP request — a script, a CI job, a monitor, or an AI agent. One curl and your phone buzzes.

I'm not getting notifications

Check notification permission for Knockbox in iOS Settings.
Open the channel and check whether you muted it — a muted channel is archived but never pushed.
If the message appears in the app but never buzzed, the channel's interruption level may be set to Quiet, or your Focus mode is filtering it. Time Sensitive breaks through Focus.

Notifications arrive but without the full text or image

The notification carries a summary; the full body is fetched from your server as the notification lands. If your server is only reachable on your home network, that fetch fails while you are away — the notification still arrives, just without the extras, and everything syncs when you get home.

Can I use several devices?

Yes. From a device that is already connected, generate a pairing code and scan it with the new one. Both then receive the same messages and share read state.

I lost all my devices

If you used a public instance, there is no account and no password, so there is no way to recover that identity — this is stated when you join. If you self-host, your data is on your own server and a new device can simply pair again.

How do I delete my data?

Delete a message by long-pressing it, or clear a whole channel from its settings. Both are physical deletions on the device and on the server. Deleting the app removes everything local.