V1 Setting V2 Setting Description
Master enable Network

Master enable switch for the entire Ethernet network functionality.

When disabled, the network module is completely unloaded to free system resources (approximately 8KB RAM).

Must be set to true to use any network feature. V1 and V2 expose different service sets, described on the Network page.

Frees ~8KB RAM when disabled
HTTP false

If set to true, enables the HTTP server on port 80. It serves static files from /sd/www and exposes the /command and /upload WebSocket endpoints.

The service itself does not provide authentication or encryption. Restrict it to a trusted network.

Sample configurations commonly set this to true
Network shell false

If set to true, enables the raw network shell on port 23, which behaves much like a serial interface and supports up to three clients.

The protocol is unencrypted and has no authentication. Use it only on a trusted network.

Sample configurations commonly set this to true Renamed to shell_enable in V2
Not in V2 Plan9 false Requires custom build

If set to true, enables the Plan9 (9P/Styx) network filesystem on port 564, which allows mounting the Smoothieboard SD card as a network filesystem on Linux systems.

Provides direct filesystem access similar to NFS or SMB.

NOT built into Smoothie by default - requires rebuild with PLAN9=1
IP Configuration auto

Configures the IP address assignment method for the Smoothieboard.

Set to auto to use DHCP for automatic configuration, or specify a static IP address (e.g., 192.168.1.100).

When using a static IP, you must also configure and .

If shows 173.222.239.190, DHCP failed - use static IP instead
IP Configuration 255.255.255.0

Defines the subnet mask for static IP configuration — the netmask determines which portion of the IP address identifies the network and which portion identifies the host.

Only used when is set to a static IP (not auto).

With DHCP, this setting is ignored and the subnet mask is provided automatically by the DHCP server.

255.255.255.0 = Class C network (254 hosts)
IP Configuration V1: 192.168.1.254; V2: 192.168.1.1

Specifies the default gateway (router) IP address for static IP configuration — used for routing traffic outside the local network.

Only used when is set to a static IP (not auto).

With DHCP, the gateway is provided automatically by the DHCP server.

Common home router: 192.168.1.1
Not in V2 MAC Address Rarely needed

Allows manual override of the Ethernet MAC (Media Access Control) address.

By default, Smoothieboard auto-generates a unique MAC address based on the CPU's serial number, using a cryptographic hash.

Only set this if you experience MAC address conflicts on your network, or need to preserve a specific MAC address after hardware replacement.

Each device on a network must have a unique MAC address Auto-generated format: 00:1F:11:02:04:xx
DHCP DNS Name

Sets a hostname that is sent to the DHCP server during IP address requests.

Some DHCP servers register this hostname in local DNS, letting you access the Smoothieboard by name (e.g., http://smoothie-cnc/) instead of by IP address.

Only used when is set to auto (DHCP mode); has no effect with static IP configuration.

Hostname support depends on DHCP server capabilities smoothie-cnc, laser-cutter, printer3d
Not documented for V1 here DNS auto

Uses the DHCP-provided DNS server when set to auto, or sets an explicit DNS-server address.

DNS is required when , , or a wget URL uses a hostname.

Not in V1 FTP false

Enables the Smoothieware V2 FTP server on TCP port 21.

This is unencrypted standard FTP. It is neither SFTP nor the V1 Simple File Transfer Protocol service on port 115.

Not in V1 NTP true

Requests the time from an NTP server when the V2 network starts and writes it to the real-time clock.

The network and DNS configuration must work before hostname-based NTP servers can resolve.

Not in V1 NTP pool.ntp.org

Sets the hostname of the NTP server used by Smoothieware V2.

Not in V1 NTP 0

Applies a fixed integer offset in hours to the NTP result before setting the V2 real-time clock.

It does not implement daylight-saving rules or fractional-hour time zones. Use zero to keep the clock on UTC.

This is a wiki! If you'd like to improve this page, you can edit it on GitHub.