built 1 min verified 2f6dc6b (2026-09-24)
Connect to the Wi-Fi
Lightning Mesh is a network of ordinary routers that talk to each other directly. You join it like any Wi-Fi network. No account and no password.
Status: built.
Before you start (one radio)
A phone or laptop has one Wi-Fi radio. Joining this network drops the Wi-Fi you were using for the internet (home, café, "Pirate Radio", …). That is expected. Do not change your default route on a machine you still need as a working uplink unless you mean to.
Step 1: Find the network
Do: open your Wi-Fi settings and look for the network your host named.
| Setup | Network name |
|---|---|
| New router, factory settings | ⚡ (a single lightning-bolt character) |
| The project's home fleet | Lightning Mesh |
| Someone else's mesh | Whatever they called it. Ask them |
Expect: the network shows as open (no lock icon).
If not: the host added a password. Ask them for it. Networks named
mjolnir-mesh are the routers' own link to each other; phones can't join
those.
Step 2: Join
Do: tap the network name.
Expect: you connect within a few seconds. If the mesh has no internet right now, a sheet may explain that the local mesh is still available. That is the next page, not a login.
Joining the Wi-Fi doesn't make you a member of anything or create an account. It just gets you on the network.
Step 3: Confirm you're on the mesh
Do: look at your connection details (on a phone: tap the network name;
on a laptop: ipconfig getifaddr en0 on a Mac, ip -4 addr on Linux).
Expect: an address that starts with 10.42., for example 10.42.61.23,
with a router address ending in .1, for example 10.42.61.1. That router
address tells you which router you're connected to.
If not: you're on a different network. Check the name in step 1.
Walking around (roaming)
You land on whichever client radio is strongest. Each router owns its own
10.42.x.0/24, so two people in the same room can have different prefixes.
| What the software does | What you should expect |
|---|---|
| Same SSID on every box | You stay on "the house Wi-Fi" as you walk |
| Household DHCP: first MAC keeps its IP, every AP can OFFER it | Often you keep 10.42.a.b when you change radios |
| Guest path: if you kept another node's IP, the visited node installs a host route | Built; not proven on every phone |
| Live TCP/UDP sessions (a call, a download) | May still drop or stall. Reconnect the app |
Do not plan a long call on a walk across the building yet.
Good to know
- Internet: you get internet if any router in the mesh has a working
uplink and is allowed to share it (
gateway=auto). hello.mesh and.meshnames work with no internet at all. - Some phones hide
.meshnames. If your phone uses "Private DNS" or your browser uses "secure DNS", turn it off for this network. See Troubleshooting.
Next: Say hello.