Skip to content

Join a mapping region

FreqMapper uses enrollment codes while the network is being built. That keeps the shared mapping channel and coverage results useful while each region gets established.

During the current public beta, use the shared code listed on the Getting started page. The code may expire, reach its use limit, or be replaced. If that happens, ask the FreqMapper community or your region administrator for the current code.

What to ask for

If the public beta code is unavailable, contact your region administrator and ask for a FreqMapper invite key. They may share a key with a small group or use one that has a set number of uses. Keys can also expire or be turned off when a testing round is finished.

Use the actual key they give you — it starts with FM-ENROLL-. Do not use an admin-page hash, a screenshot of a key that has already been redeemed, or a normal Meshtastic channel key.

Use it in the app

  1. Install FreqMapper and open the Radio tab.
  2. Connect and let your Meshtastic radio finish synchronizing.
  3. Open Settings and paste the one-time region invite key.
  4. Read the radio name shown under the field, then tap Apply invite key.
  5. FreqMapper binds this app installation to that connected radio, fetches the shared wardriving channel, and clears the invite key from your phone.

The button stays unavailable until a radio is fully connected. That is intentional: an invite key enrolls a particular radio, not a loose phone or a name somebody typed in.

Tip

One successful enrollment is enough for that app and radio. Treat any region-specific replacement key as private. If you replace the phone or radio, ask your region administrator for help rather than trying to reuse an old key.

If it does not work

  • Check that you pasted the complete key with no extra characters.
  • Make sure the radio says connected rather than merely appearing in the scan list.
  • Ask your region administrator whether the key expired, was revoked, or has reached its use limit.
  • If the radio was previously enrolled to another app installation, an administrator needs to revoke that old registration first.

Last updated: 2026-09-02