The Network config options include: NTP Server, WiFi Enabled, WiFi SSID, WiFi PSK, Ethernet Enabled, IPv4 Networking Mode, Static Address, rsyslog Server, and Protocol Flags. Network config utilizes an admin message to send a Config.Network protobuf.
Note: Enabling WiFi will disable Bluetooth, meaning only one connection method will 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.
Network Config Values
-
NTP Server: The NTP server used when IP networking is available, set to meshtastic.pool.ntp.org by default. (Maximum length: 32)
-
WiFi Enabled: Enables or disables WiFi, set to false (disabled) by default.
-
WiFi SSID: This is your WiFi network's SSID, which is empty ("") by default. (Case sensitive, maximum length: 32)
-
WiFi PSK: This is your WiFi network's password, which is also empty ("") by default. (Case sensitive, maximum length: 64)
-
Ethernet Enabled: Enables or disables Ethernet, set to false (disabled) by default.
-
IPv4 Networking Mode: Set to DHCP by default. Change to STATIC to use a static IP address. This applies to both Ethernet and WiFi.
-
IPv4 Static Address Configuration: Contains IP, Gateway, Subnet, and DNS server for a static configuration if selected in Networking Mode.
-
Rsyslog Server: Configures an rsyslog Server and Port. The default logging 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 (bitwise OR of ProtocolFlags).
| 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 will be saved for future reuse.
Network Configuration Client Availability
Android
Network Config options are available for Android.
-
Open the Meshtastic App.
-
Navigate to: Vertical Ellipsis (three dots in the top right) > Radio Configuration > Network.
Apple
All Network config options are available on iOS, iPadOS, and macOS under Settings > Device Configuration > Network.
CLI
All Network config options are available in the Python CLI.
| 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" |
NOTE: Since the device will reboot after each command is sent via CLI, it is recommended to chain commands together as one when setting multiple values in a config section. For example:
| meshtastic --set network.wifi_enabled true --set network.wifi_ssid "my network" --set network.wifi_psk mypassword |
Web
All Network config options are available in the Web UI.
Examples
WiFi Client
With network.wifi_ssid and network.wifi_psk populated, the device will know to connect to your network. Make sure you are in range of your WiFi and that it is a 2.4GHz-only network. If you have a single Meshtastic device on your local network, it’s easy to connect to your device using the DNS http://meshtastic.local. If you have multiple Meshtastic devices, you will need to connect using their respective IP addresses.
Disable WiFi
To completely disable WiFi, set network.wifi_enabled to false.
