Connect to the Network

The MeshTexas broker accepts connections from any Texas-area MeshCore observer. Auth uses the same JWT model as MeshMapper and Waev — your device signs its own token from its keypair. No credentials or registration required.

Brokermqtt.meshtexas.org

Port443

TransportWebSocket Secure (WSS)

AuthJWT — auto, from device keypair

Only listed region codes are accepted

Devices tagged with a region code that isn't in the list below won't be able to connect. Don't see your area? Let us know and we'll add it.

Setup Instructions

Select the software your observer is running:

For Heltec V3/V4, T-LoRa, Tracker, and any ESP32-based board running the agessaman MeshCore firmware with MQTT bridge support.

Open a command line to your device — expand the method you're using:
Via USB Serial
Connect via USB serial at 115200 baud using a terminal (PuTTY, screen, minicom) or the MeshCore serial console.
Via Bluetooth Companion App
Open the MeshCore companion app, connect to your device over Bluetooth, then navigate to Remote Management → Command Line — all commands below are entered there, no USB cable needed.
Set your region using the IATA code for the Texas city nearest to you:
SAT San AntonioAUS AustinHOU HoustonDFW Dallas–Fort WorthELP El PasoABI AbileneAMA AmarilloMFE McAllenSJT San AngeloTXK TexarkanaCRP Corpus ChristiACT Waco
```
set mqtt.iata SAT
```
Pick a free broker slot (mqtt1–mqtt6). Not sure which are free? Run get mqtt1.preset through get mqtt6.preset and use one that shows none.

Configure the slot — replace mqtt1 with your chosen slot:

set mqtt1.preset custom
set mqtt1.server mqtt.meshtexas.org
set mqtt1.port 443
set mqtt1.audience mqtt.meshtexas.org
save
reboot

Confirm the connection after reboot:
```
get mqtt.status
```
You should see mqtt1: connected.

For RAK4631 and any serial-connected MeshCore device running meshcoretomqtt.

Find your config directory — typically /etc/mctomqtt/config.d/ on Linux.
Set your IATA region — replace SAT with the Texas city nearest to you, then expand the option that matches your setup:
SAT San AntonioAUS AustinHOU HoustonDFW Dallas–Fort WorthELP El PasoABI AbileneAMA AmarilloMFE McAllenSJT San AngeloTXK TexarkanaCRP Corpus ChristiACT Waco
Choose your setup
Connecting to Multiple Region Brokers
Sets IATA only for the MeshTexas broker — safe when you're also connected to other regional meshes. Create 30-texasmesh.toml in config.d/:
```
[[broker]]
name = "meshtexas"
enabled = true
server = "mqtt.meshtexas.org"
port = 443
transport = "websockets"
keepalive = 60
qos = 0
retain = true

[broker.tls]
enabled = true
verify = true

[broker.auth]
method = "token"
audience = "mqtt.meshtexas.org"

[broker.topics]
iata = "SAT"
```
Only Connecting to Texas Brokers
Simpler option — sets IATA globally. Create or edit /etc/mctomqtt/config.d/99-user.toml:
```
[general]
iata = "SAT"
```
Then create 30-texasmesh.toml in config.d/ without a [broker.topics] block:
```
[[broker]]
name = "meshtexas"
enabled = true
server = "mqtt.meshtexas.org"
port = 443
transport = "websockets"
keepalive = 60
qos = 0
retain = true

[broker.tls]
enabled = true
verify = true

[broker.auth]
method = "token"
audience = "mqtt.meshtexas.org"
```
Restart meshcoretomqtt and watch the logs for a connection confirmation:
```
sudo systemctl restart meshcoretomqtt
journalctl -u meshcoretomqtt -f
```

Run ls /etc/mctomqtt/config.d/ to see what files already exist before picking a number.

For any MeshCore observer running meshcore-packet-capture.

Find your presets directory inside your meshcore-packet-capture installation.
Set your IATA region — replace SAT with the Texas city nearest to you, then expand the option that matches your setup:
SAT San AntonioAUS AustinHOU HoustonDFW Dallas–Fort WorthELP El PasoABI AbileneAMA AmarilloMFE McAllenSJT San AngeloTXK TexarkanaCRP Corpus ChristiACT Waco
Choose your setup
Connecting to Multiple Region Brokers
Sets IATA only for the MeshTexas broker — safe when you're also connected to other regional meshes. Create meshtexas.toml in your presets directory:
```
[[broker]]
name = "meshtexas"
enabled = true
server = "mqtt.meshtexas.org"
port = 443
transport = "websockets"
keepalive = 60
qos = 0
retain = true
iata = "SAT"

[broker.tls]
enabled = true
verify = true

[broker.auth]
method = "token"
audience = "mqtt.meshtexas.org"
```
Only Connecting to Texas Brokers
Simpler option — sets IATA globally. Create or edit /etc/meshcore-packet-capture/config.d/99-user.toml:
```
[general]
iata = "SAT"
```
Then create meshtexas.toml in your presets directory without an iata line:
```
[[broker]]
name = "meshtexas"
enabled = true
server = "mqtt.meshtexas.org"
port = 443
transport = "websockets"
keepalive = 60
qos = 0
retain = true

[broker.tls]
enabled = true
verify = true

[broker.auth]
method = "token"
audience = "mqtt.meshtexas.org"
```
Restart the service and check logs for a successful broker connection.

✓

Verify your connection

After connecting, search for your node name on the MeshTexas Analyzer. It should appear within a few minutes of your device sending its first advert packet.

Open Analyzer ↗