MeshCore/Getting Started

---

🏴󠁧󠁢󠁳󠁣󠁴󠁿 What is ScotMesh?

ScotMesh is community radio messaging networks across Scotland. It uses small, low-power LoRa radios to carry short messages between people — no mobile network, no Wi-Fi, no internet required. Think of it like a local text messaging service that works off-grid, powered by volunteer-run repeaters dotted across the country.

ScotMesh runs both Meshtastic and MeshCore. This guide covers MeshCore.

Never used MeshCore before? Good — this is the place to start. No radio knowledge needed.

This guide is written for companion node devices — small LoRa radios that pair with the MeshCore Companion App on your phone. More capable standalone devices do exist, but those are out of scope for this guide. If you are setting one of those up, ask in the Discord for advice.

🎒 What you need

• A MeshCore companion node — a small LoRa radio that pairs with your phone over Bluetooth.
• A smartphone — Android or iPhone both work.
• That is it.

Not sure which companion node to get? Ask in the Discord and the community can point you in the right direction.

📱 1. Get the app

Download the MeshCore Companion App on your phone.

• Android: MeshCore on Google Play
• iPhone: MeshCore on the App Store

Open the app once it has installed.

👨‍💻 2. Flash the Latest Firmware to the LoRa Device

Before configuring the node, flash the LoRa device with the latest correct firmware for your exact hardware.

Important: Do not use the firmware that came pre-installed on the node.

Pre-installed firmware may be outdated, built for a different board variant, or configured incorrectly for our mesh. Using the wrong firmware can cause connection issues, missing features, failed regional settings, or unreliable repeater behaviour.

Download the latest firmware from https://meshcore.io/, making sure you select the correct build for your exact device type, for example:

• RAK4631
• Heltec
• T114
• SenseCAP
• Waveshare
• Other supported hardware

After flashing, reboot the device and confirm the firmware version before continuing with the rest of the setup.

🔵 3. Connect your device

1. Make sure your LoRa device is powered on.
2. In the app, tap Add Device or the connect button.
3. The app will search for nearby devices over Bluetooth. Select yours from the list.
4. Wait a moment for it to connect. You should see your device appear in the app.

If the device does not show up, make sure Bluetooth is enabled on your phone and that the device is in pairing mode. Check your device’s instructions if you are unsure.

⚙️ 3. The companion node settings

Regions split the mesh into geographic areas so traffic stays local and relevant, while agreed neighbours still interconnect. Your node's default scope is the region it uses for any traffic that has no scope of its own — which is why getting it right matters.

Before you can send anything from your companion app, you need to set it up for use in the ScotMesh MC mesh.

Connecting a Newly Flashed Companion Node to ScotMesh

After flashing the latest companion-node firmware, use the MeshCore app to connect to the node by Bluetooth and configure it for ScotMesh.

1. Power on the node, open the MeshCore app, and connect to it over Bluetooth — on the connect screen, scan and select your node.
2. Confirm the firmware version shown is the latest correct build for your device, then give the node a clear, recognisable name so other ScotMesh users can spot it.
3. Open the node settings and set the radio region to UK/EU.
4. On the main Settings screen, set Default Scope to sco and Default Hash Size to 3 byte. (Older app versions kept these under Experimental Settings.)
5. Save, reboot if prompted, then reconnect and check both settings are still set.
6. Open the ScotMesh channel and send a test message, for example Test from my new ScotMesh node, to confirm it sends.

Once these steps are complete, the companion node should be connected to ScotMesh and ready to send messages using the Scottish default scope.

The default scope is the most important setting on ScotMesh. Without it, your messages may not travel anywhere useful on our network.

💬 4. Send your first message in the #scotland channel.

1. In the app, open or create a channel called #scotland.
2. Check the channel scope is set to sco. If the app shows a scope option, make sure it says sco.
3. Type a short hello and send it.

That is all you need to do. If there is a repeater nearby, your message should travel through the mesh.

🤔 5. Nothing coming back?

Do not worry — this is normal at first.

• Check your scope. Go back to step 2 and confirm sco is set as the default and on the #scotland channel.
• Check repeater coverage. It is best NOT TO USE MeshCore Node Map to see if there are any repeaters near you. It is not up to date and can give false promise of coverage. Use the discover nearby nodes Scanner in the MeshCore app tools. > The web map is inaccurate and always out of date. The companion app map will be empty until it hears adverts. the only way to reliably check for repeaters is to use the repeater search tool in the companion app
• Try #test. Send a message in a channel called #test with scope sco — this is what the community uses for testing. If someone else is active they may respond.
• Ask for help. The Discord is friendly and someone will help you work out what is happening.

🗺️ Where to go next

Once you are up and running:

• Scopes explains what scope means and how to set it properly for different channels.
• Channels lists the agreed community channels and what scope to use with each.
• Repeater Quick Setup is for you if you want to set up a repeater and help the network grow.