openelab.de
openelab.com
Meshtastic Guide - Meshtastic Bluetooth Settings
The Network configuration options in Meshtastic are designed to give you full control over how your device connects to a LoRa mesh network and integrates with broader IP networking. These options include: NTP Server, WiFi Enabled, WiFi SSID, WiFi PSK, Ethernet Enabled, IPv4 Networking Mode, Static Address, rsyslog Server, and Protocol Flags. Configuration is managed through an administrative message that sends a Config.Network protobuf.
Important Note: Enabling WiFi will disable Bluetooth, meaning only one connection method can be active at a time. Additionally, ESP32 devices can connect to WiFi as a client, but SoftAP mode is not supported by the Meshtastic firmware. This ensures stability across the mesh network.
Network Config Values
- NTP Server: The default server is meshtastic.pool.ntp.org. This synchronizes device time when IP networking is available.
- WiFi Enabled: Controls whether WiFi is active. Default is false.
- WiFi SSID: Your WiFi network name. Case sensitive, maximum length 32.
- WiFi PSK: Your WiFi password. Case sensitive, maximum length 64.
- Ethernet Enabled: Enables or disables Ethernet. Default is false.
- IPv4 Networking Mode: Default is DHCP. Change to STATIC for a fixed IP configuration.
- IPv4 Static Address Configuration: Includes IP, Gateway, Subnet, and DNS server values when using static mode.
- Rsyslog Server: Allows configuration of a logging server and port. Default facility is user.
- Protocol Flags: Defines which auxiliary network protocols are used to send packets. Values are stored as a bit field of boolean configuration options.
| Value | Description |
| NO_BROADCAST | Do not broadcast packets over any network protocol |
| UDP_BROADCAST | Enable broadcasting packets via UDP over the local network |
Note: The first time your device restarts after enabling WiFi or Ethernet, it will take an additional 20–30 seconds to boot, as it generates self-signed SSL keys. These keys are saved for future reuse, ensuring secure network communication.
Network Configuration Client Availability
Android
All Network configuration options are available on Android:
- Open the Meshtastic App.
- Navigate to: Three-dot menu → Radio Configuration → Network.
Apple
On iOS, iPadOS, and macOS, go to Settings → Device Configuration → Network.
CLI
All Network configuration options are available in the Python Command Line Interface. Example commands:
| Setting | Acceptable Values | Default |
| network.ntp_server | string | meshtastic.pool.ntp.org |
| network.wifi_enabled | true, false | FALSE |
| network.wifi_ssid | string | "" |
| network.wifi_psk | string | "" |
| network.eth_enabled | true, false | FALSE |
| network.address_mode | DHCP, STATIC | DHCP |
- Set NTP Server
| meshtastic --set network.ntp_server "meshtastic.pool.ntp.org" |
- Enable / Disable WiFi
| meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_enabled false |
- Set WiFi SSID
| meshtastic --set network.wifi_ssid mynetwork // With spaces meshtastic --set network.wifi_ssid "my network" |
- Set WiFi password
| meshtastic --set network.wifi_psk mypassword // With spaces meshtastic --set network.wifi_psk "my password" |
Tip: Since the device reboots after each CLI command, chain commands together to save time:
| meshtastic --set network.wifi_enabled true --set network.wifi_ssid "my network" --set network.wifi_psk mypassword |
Web
All Network configuration options are available in the Web User Interface.
Examples
WiFi Client
With network.wifi_ssid and network.wifi_psk populated, the device will connect to your WiFi. Ensure you are within range of a 2.4GHz-only network. If you have a single Meshtastic device, you can connect using http://meshtastic.local. With multiple devices, connect using their individual IP addresses.
Disable WiFi
To disable WiFi completely, set network.wifi_enabled to false.
