Skip to main content

Network Configuration

The Network config options are: WiFi Enabled, WiFi SSID, WiFi PSK, Ethernet Enabled, IPv4 Networking Mode, Static Address and NTP Server. 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 0.pool.ntp.org by default. (Max Length: 33)

WiFi Enabledโ€‹

Enables or Disables WiFi.

Set to false (Disabled) by default.

WiFi SSIDโ€‹

This is your WiFi Networks SSID.

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

WiFi PSKโ€‹

This is your WiFi Networks 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โ€‹

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_pskstring""
network.wifi_ssidstring""
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. 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.

If you have a screen attached to your device, the final page will display something similar to the following:

WiFi: Software AP (Admin)
IP: 192.168.42.1 (0/4)
SSID: myNetwork
http://meshtastic.local
* * * * *

You should then be able to connect to the node using either the displayed IP address or the HTTP link.

Disable WiFiโ€‹

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