Skip to main content

Channels and Regions

MeshCore channels are used to separate different kinds of conversations on the mesh. Keep public traffic simple and predictable so new users can find help, test their node, and understand which channel is appropriate for their message.

Channel Types

TypeHow it worksTypical use
PublicThe default shared channel available to MeshCore users.General chat, first contact, and simple coordination.
HashtagA named channel with a key generated from the channel name.Regional chat, topic channels, testing, and repeatable community channels.
PrivateA channel using a private key shared only with trusted participants.Small teams, event operations, or conversations that should not be readable by the broader mesh.

Public and hashtag channels should be treated as public. They may be heard by repeaters, observers, and other users, and they may appear in internet-connected tools if observers are present.

Private channels are only private if the key stays private. Do not reuse a private channel name or key for unrelated groups.

Regions

Region help restrict propagation of channels across the wider MeshCore mesh. Use the smallest scope that makes sense so local traffic stays local where supported.

You can easily check which region using the Eastmesh Region Tool.

It is bad practice to scope the Public channel to a region as this can lead to one-sided conversations.

Use lower-case components separated by hyphens.

Format:

<country>-<state>-<iata>

Example:

au-nsw-syd

In this format:

PartExampleMeaning
CountryauAustralia.
StatenswNew South Wales.
IATAsydThe nearest practical airport or regional IATA-style code. Otherwise a community agreed 3rd tier name where IATA isnt practical

Examples:

RegionSuggested useCLI commandWho
auAustralia-wide scoped traffic.region put au
region allowf au
Everyone
au-nswNSW-wide scoped traffic.region put au-nsw
region allowf au-nsw
Everyone
au-nsw-sydSydney metro scoped traffic.region put au-nsw-syd
region allowf au-nsw-syd
Sydney
au-nsw-gosCentral Coast scoped traffic.region put au-nsw-gos
region allowf au-nsw-gos
Gosford
au-nsw-ntlNewcastle and Hunter scoped traffic.region put au-nsw-ntl
region allowf au-nsw-ntl
Newcastle
au-nsw-wolIllawarra and Wollongong scoped traffic.region put au-nsw-wol
region allowf au-nsw-wol
Wollongong
SaveSave the regions.region saveEveryone

A Sydney-specific message belongs in a Sydney channel scoped to au-nsw-syd; a state-wide message belongs in an NSW channel scoped to au-nsw; general first contact can stay in Public.

All NSW repeaters should generally allow au and au-nsw. Only add the IATA-level region that matches the repeater location. For example, Sydney repeaters should allow au-nsw-syd, Central Coast repeaters should allow au-nsw-gos, Newcastle and Hunter repeaters should allow au-nsw-ntl, and Illawarra repeaters should allow au-nsw-wol.

For communities that border multiple states (e.g. Albury/Wodonga) they may be using an area specific 2nd tier like au-hume.

For a deeper explanation of MeshCore regions, see Zindello Industries' article MeshCore Regions: what they are, how they work, and why they matter.

Current Channels

KeySuggested region scopePurpose
PublicNoneGeneral chat for all mesh users.
#testAll usersConnection testing. Bots may auto-reply to test, ping, or path where available.
#emergencyAll usersEmergency communications only.
#sydneyau-nsw-sydSydney metro conversation and coordination.
#nswau-nswState-wide coordination.
#macarthurau-nsw-sydMacarthur conversation and coordination.
#nepeanau-nsw-sydNepean conversation and coordination.
#centralcoastau-nsw-gosCentral Coast conversation and coordination.
#illawarraau-nsw-wolIllawarra and Wollongong conversation and coordination.
#newcastleau-nsw-ntlNewcastle and Hunter conversation and coordination.

Check with the NSW Mesh community before creating a new long-lived regional or operational channel.