SolarOS 4.13.4 manual · service

Device identity

The device user and hostname are stored in NVS, so they do not depend on an SD card. The shell prompt uses both values. Gateway Chat uses both values when it connects, and network services use the hostname when advertising the device.

Inspect and change identity

From the shell:

identity status
identity user nils
identity hostname solarterm

From Python:

import solaros

print(solaros.identity.format())
solaros.identity.set_hostname("solarterm")

If Wi-Fi is already initialized, reboot before expecting every advertisement or DHCP hostname to use a changed value.

If Gateway Chat is already connected, run gateway connect to reconnect with the changed identity.

Quick reference

solaros.identity provides user(), hostname(), set_user(name), set_hostname(name), and format(). Values are NVS-backed. Reboot before expecting an already initialized Wi-Fi interface to advertise a changed hostname.