Skip to main content

Network Configuration

The Network config options are: NTP Server, WiFi Enabled, WiFi SSID, WiFi PSK, Ethernet Enabled, IPv4 Networking Mode, and Static Address. Network config uses an admin message sending a Config.Network protobuf.

info

Enabling WiFi will disable Bluetooth. Only one connection method will work at a time.

ESP32 devices have the ability to connect to WiFi as a client. SoftAP mode is not supported by the Meshtastic firmware.

Network Config Values

NTP Server

The NTP server used if IP networking is available.

Set to meshtastic.pool.ntp.org by default. (Max Length: 32)

WiFi Enabled

Enables or Disables WiFi.

Set to false (Disabled) by default.

WiFi SSID

This is your WiFi Network's SSID.

Empty "" by default. (Case Sensitive, Max Length: 32)

WiFi PSK

This is your WiFi Network's password.

Empty "" by default. (Case Sensitive, Max 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. Applies to both Ethernet and WiFi.

IPv4 Static Address configuration

contains ip, gateway, subnet and dns server in case you want a static configuration.

tip

The first time your device restarts after enabling WiFi or Ethernet, it will take an additional 20-30 seconds to boot. This is to generate self-signed SSL keys. The keys will be saved for future reuse.

Network Config Client Availability

CLI

info

All Network config options are available in the python CLI.

SettingAcceptable ValuesDefault
network.ntp_serverstring0.pool.ntp.org
network.wifi_enabledtrue, falsefalse
network.wifi_ssidstring""
network.wifi_pskstring""
network.eth_enabledtrue, falsefalse
network.address_modeDHCP, STATICDHCP
tip

Because the device will reboot after each command is sent via CLI, it is recommended when setting multiple values in a config section that commands be chained together as one.

Example:
meshtastic --set network.wifi_enabled true --set network.wifi_ssid "my network" --set network.wifi_psk mypassword
Set NTP Server
meshtastic --set network.ntp_server "0.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"

Examples

WiFi Client

With network.wifi_ssid & network.wifi_psk populated, the device will know to connect to your network. Make sure you are in range of your WiFi and 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 with DNS http://meshtastic.local. If you have multiple Meshtastic devices you will need to connect using their respective IP addresses.

Disable WiFi

To disable WiFi completely, set network.wifi_enabled to false.