Skip to main content

Network Settings

Hostname and WiFi credentials.


GET /api/setting/network

Response

{
"Hostname": "nm-cyd-c5-ab12cd",
"WiFiSSID": "MyHomeAP"
}
FieldTypeMeaning
HostnamestringmDNS / NetBIOS hostname the miner announces.
WiFiSSIDstringConfigured WiFi SSID.

The current WiFi password is never returned.


POST /api/setting/network

Partial update — include only the keys you want to change.

Request

{
"Hostname": "garage-miner-01",
"WiFiSSID": "MyHomeAP",
"WiFiPWD": "supersecret"
}
FieldTypeRequiredMeaning
HostnamestringnoNew hostname (alphanumeric and - recommended).
WiFiSSIDstringnoNew WiFi SSID.
WiFiPWDstringnoNew WiFi password. Write-only.

Response

HTTP/1.1 200 OK
Content-Type: text/plain

OK

400 if the body is not valid JSON.

Example

curl -X POST http://192.168.1.42/api/setting/network \
-H "Content-Type: application/json" \
-d '{"Hostname":"garage-miner-01"}'
warning

Changing WiFi credentials does not restart networking immediately. The next boot uses the new settings.