Knockbox — Support

Contact

Email info@miramiao.com. One person reads it, usually within a day or two.

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.

Do I need a server?

You can scan the QR code on a public instance and start using it immediately, or run the open-source server yourself on any machine. Self-hosting means the messages never leave your hardware.

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.