BoxOnPost
FAQ

Questions and answers

The questions people ask most. Tap a question to see the answer. Can't find yours? See the Community page.

About BoxOnPost

What is BoxOnPost?

BoxOnPost is firmware for MeshCore companion radios. When you send a direct message and the other person's radio can't be reached, your radio keeps a copy and keeps trying until their radio confirms it got the message. Everything else in MeshCore works exactly as before.

Does the person I'm messaging need BoxOnPost too?

No. Messages are delivered to radios running normal MeshCore. If they also run BoxOnPost, their radio can tell yours when they're back in range, so delivery can happen sooner.

Do I need a different phone app?

No. Keep using the official MeshCore app. Your contacts, channels and settings stay the same.

Which radios does it work on?

Heltec V3, V4 and V4 R8 (small screen or touch screen) and the ThinkNode M1 are ready now. Many more (Heltec T114 and Wireless Tracker, ThinkNode M2 to M9, RAK, Seeed and LILYGO radios) are being tested. The full list is on the Firmware page; radios marked Testing become available once they've been tried on real hardware.

Does it go on my repeater?

No. BoxOnPost is for the radio you send messages from (your companion radio). Repeaters stay on the official MeshCore repeater firmware. BoxOnPost works with any repeater as it is.

Using it

The app says my message “failed”. Is it lost?

No. “Failed” means the app stopped waiting. Your radio still holds the message and keeps trying. When it gets through, the radio's screen shows Delivered, and the app may update too.

Since version 0.6: the app's “failed” can switch to delivered when the message gets through, and a note appears in the BoxOnPost Status channel, for example ✓ Delivered to Don: “Are you coming tonight…” (2h late).

How do I know a message was delivered?

On radios with a screen, a Delivered: (name) message pops up and the MAILBOX page count goes down. From version 0.6, a note also appears in the BoxOnPost Status channel in the app, on every radio. Before 0.6, on radios without a screen, the other person receiving it is the proof. “Delivered” means it reached their radio, not that they've read it.

How long does my radio keep trying?

2 days by default. On the radio's HOLD MESSAGES page you can choose Off, 2, 5 or 15 days (radios updated from 0.7.x keep 5 days). It tries often at first (after 2, 5 and 15 minutes, then every 30 minutes), then less often: every 3 hours after 12 hours, and once a day after 2 days. It also tries right away when it hears the other person, or when it comes back into range of the mesh.

How many messages can it hold?

100 on the Heltec V4, 50 on the Heltec V4 R8 and V3, 64 on the ThinkNode M2, M5, M7 and M9, and 48 on the Heltec T114 and ThinkNode M1 and M3. Up to 10 per person; an 11th pushes out that person's oldest.

Does my phone need to stay connected?

No. The radio does the work on its own. It just needs to be switched on.

What if my radio loses power or restarts?

Held messages are saved in the radio's memory, so they survive a restart or a dead battery and carry on when it's back on. Messages you receive while your phone isn't connected are saved too, until your phone collects them.

Does it hold channel messages?

No, only direct messages. MeshCore channel messages have no delivery confirmation, so there's nothing to wait for.

Can the other person get the same message twice?

Rarely. If their radio received it but its “got it” reply was lost on the way back, your radio sends it again.

Since version 0.6: a BoxOnPost radio remembers what it has already received. A repeat isn't shown again, but the radio still answers “got it”, so the sender stops trying. This works between BoxOnPost radios; a radio on plain MeshCore can still rarely show a double.

What does “~BOP” at the end of a message mean?

Added in version 0.6. It means the message was held by the sender's BoxOnPost mailbox and delivered late, for example because your radio was off or out of range. Messages that go straight through don't get it. If a message is right at the length limit, the tag is left off rather than cutting any words.

What is the “BoxOnPost Status” channel?

Added in version 0.6. It's a private channel your radio adds to the MeshCore app to tell you about held messages: when one is delivered late, if the mailbox was full, or if it gave up when the hold time ran out. Notes are one line each and wait on the radio until your app connects.

It exists only on your radio. Nothing is sent over the air on it, and no other radio can see it. It uses one empty channel slot and never touches your other channels; if all your slots are full, it isn't added.

Can I rename, mute or remove the BoxOnPost Status channel?

Yes. Rename it in the app to anything you like and the notes keep coming. You can mute it like any channel. If you delete it, it stays deleted. To bring it back, go to the APP NOTICES page on the radio, long press, then reconnect the app. See the Guide.

Does it use more battery?

Only a little. Retries are short and spread out. Setting HOLD MESSAGES to Off stops the retries altogether.

Can I pause it or clear the messages it's holding?

Yes. On radios with a screen, set HOLD MESSAGES to Off to pause and use CLEAR MAILBOX to delete. See the Guide.

Installing

My radio is brand new. What do I do first?

New radios usually come with other firmware, often Meshtastic or a factory test program. First install the official MeshCore Companion firmware from flasher.meshcore.io, connect the MeshCore app and check that it works. Then install BoxOnPost from your radio's page.

Do I need the latest MeshCore before installing BoxOnPost?

No. Your radio just needs to be running MeshCore. BoxOnPost replaces the whole firmware with its own copy of MeshCore (currently version 1.18.0) plus the BoxOnPost features, so the version you had before doesn't matter. If your radio runs a MeshCore version newer than that, back up your private key first.

Will I lose my contacts or settings?

No. The normal install keeps your identity, contacts and settings. Still, save a copy of your private key first; it's step 1 on every radio's page.

Which file do I need?

Go to the Firmware page and pick your radio. Heltec radios flash straight from the website: plug in by USB and click Flash (Chrome or Edge on a computer). Other radios get one file to download and drag onto the radio.

My radio won't start after installing.

Install the official MeshCore Companion firmware for your radio from flasher.meshcore.io, then install BoxOnPost again with “Erase device” unticked. The “Something went wrong?” section on your radio's page has the details.

Can I go back to normal MeshCore?

Yes, any time. Install the official firmware the same way, and your identity and contacts are kept. Each radio's page shows how.

What happens when MeshCore releases an update?

BoxOnPost is built on a specific version of MeshCore. When MeshCore releases a new version, we bring BoxOnPost up to date with it, test it, and release a new BoxOnPost version that includes the new MeshCore. Installing the official MeshCore update yourself replaces BoxOnPost, so wait for the matching BoxOnPost release if you want to keep both. Radios on different MeshCore versions can still message each other.

Is installing custom firmware risky?

Installing any firmware carries a small risk, mostly from ticking “Erase device” by mistake or unplugging halfway. Follow your radio's page step by step and keep your private key backed up, and a radio can almost always be recovered.

Privacy and safety

Are my messages encrypted?

Over the air, yes: MeshCore encrypts direct messages between radios. On your own radio, held and uncollected messages are stored as plain text. Keep your radio secure, and clear the mailbox before selling or lending it.

Does BoxOnPost collect any data?

No. It runs entirely on your radio and doesn't send anything to us.

Can I rely on it in an emergency?

No. Delivery is never guaranteed on a mesh network. Don't use BoxOnPost, or any hobby radio, as your way to call for help.

Testing and help

What does “Testing” mean on a radio?

That version is built and has passed all our checks, but nobody has run it on that radio for real yet. It becomes available to download once it has.

How can I help test?

Email us (the address is on the Community page) and say which radio you have.

Where do I get help?

Ask in #help on our Discord. For private questions, see the Community page.