Understand machine status
Also check Last seen. It tells you whether an offline event is recent or whether the machine
has been unreachable for a longer period.
Read the status LEDs
A red LED starts after repeated failed check-ins, not after a single dropped request.
Change Wi-Fi
When the machine is still online:1
Open Network
Expand the Edge machine and find Network. Check its current Wi-Fi name, signal, and IP
address.
2
Forget the saved Wi-Fi
Select Forget & show hotspot and confirm the warning.The machine forgets its saved Wi-Fi and temporarily goes offline.
3
Join the setup network
Near the Edge machine, join
Stardeck-Setup-XXXX on a phone. The setup page should open
automatically; otherwise, open http://10.42.0.1.4
Enter the new network details
Select the new Wi-Fi network and enter its password. The machine keeps its existing pairing, so
no new Stardeck pairing code is required.
5
Confirm it reconnects
Return to the dashboard and wait for the machine to show Online with the new network.
Stardeck-Setup-XXXX automatically. Reconnect it using the
same Wi-Fi-only flow.
A local network with a broadband outage still counts as a network connection. In that case, the
Edge machine stays on the local network and flashes red instead of opening its setup network.
Automatic updates
Edge software updates are automatic. The machine periodically checks for a signed release, downloads it, applies it, and confirms that it can start and reach Stardeck. If the new version fails its health check, the machine automatically returns to the previous working version. A power interruption during an update is also recovered after the next boot.
Do not unplug the machine while it shows Applying unless there is a physical safety issue.
Move, replace, or remove a machine
- Moving it to a new network: use Forget & show hotspot before unplugging it when possible.
- Replacing a printer: configure the replacement, then re-point the app’s existing alias.
- Replacing the Edge machine: pair the new machine, grant it to the same apps, and re-create or repair the affected aliases.
- Retiring or transferring it: remove its app grants, clear any displays, then remove the machine from Edge Devices.
Stardeck-Setup-XXXX network, ready to pair again. It keeps its saved Wi-Fi and its installed
software version. A machine that is switched off or offline is told the next time it checks in.
Decommissioned machines stay listed, folded away at the bottom of Edge Devices. Deleting the
record is a separate, deliberate second step.
Give the hardware to another organization
A machine’s serial number can only be registered by one organization at a time, so a transfer needs the record gone, not just decommissioned:1
Remove the machine
Its status becomes Decommissioned.
2
Wait for it to reset
Power it on with internet access and confirm it returns to
Stardeck-Setup-XXXX. If you delete
the record before it checks in, the machine takes about an hour to notice on its own — or you
can reset it by hand using the gesture below.3
Delete permanently
Open the Decommissioned section, choose Delete permanently, and the serial number is
released for the new organization.
Fix a machine by hand
When you can reach the hardware but not the dashboard — no network, no laptop, a machine someone else removed — two gestures at the machine itself cover it. Both are spelled the same way, on either:- the power button, or
- Backspace on any USB keyboard. Plug one in at any time; the machine notices within a few seconds. This is the only method on machines without a power button.
Reach for five when only the network is wrong: the machine moved rooms, or the Wi-Fi password
changed. It is the smaller of the two on purpose — a factory reset would mean re-pairing from your
dashboard to fix something that was never broken.
Change the Wi-Fi
Tap five times within five seconds. The red LED flutters rapidly for about a second, then the machine restarts and raisesStardeck-Setup-XXXX so you can give it the new network. Give it about
two minutes to appear — the machine waits to be sure the network is really gone, then looks twice
for the networks nearby so the list it shows you is complete, before raising its own.
Nothing happens the instant you stop tapping: the machine waits out the full five seconds first, in
case you are still going and meant eight. Six or seven taps do the same thing as five — only the
eighth changes the outcome.
On a machine with an Ethernet cable this does very little: the saved Wi-Fi goes, the machine
restarts, finds the wired connection still working, and carries on without ever showing a setup
network.
Factory reset
Tap eight times within five seconds. Taps have to be taps — a press held for more than a second is not one, and holding the power button is a hardware power-off the software never sees. Any other key cancels it, so the eight Backspaces have to stand alone — ordinary typing at an attached keyboard, like deleting a mistyped line, can never reset a machine by accident. After the eighth tap the green LED strobes for about two seconds, then the machine restarts ontoStardeck-Setup-XXXX. Taps also blink the green LED as you go, though at the speed the
gesture needs you should not expect one blink per tap — the strobe at the end is the signal that
counts.
The lights are how you tell the two gestures apart without counting: a steady green strobe means
the machine was reset, a rapid red flutter means only the Wi-Fi was forgotten. The flutter is
deliberately unlike the slow red blink of a machine that is merely offline. If you were going for eight
and saw red, you stopped short — the machine is still paired, and you can give it its network back
or try the eight again.
A hand reset clears the pairing and the saved Wi-Fi, so you will need the network password
again. It keeps the installed software version. A single tap of the power button still shuts the
machine down normally; a single Backspace does nothing.
Two version caveats. The power button only becomes available to either gesture after the machine
has restarted once on Edge software 0.6.0 or later — before that a tap simply shuts it down. And
the five-tap Wi-Fi gesture needs 0.7.0 or later; on an older machine five taps do nothing at
all, however many times it has restarted. The keyboard method works without a restart. The
machine’s version is shown under Software when you expand it.