Skip to main content
Manage paired Edge machines under Settings → Edge Devices. Expand a machine to see its network, peripherals, displays, and update status.

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.
Forget & show hotspot requires someone to be physically near the machine. If Ethernet is connected, the machine stays online and does not open its setup network. Disconnect Ethernet and restart the machine before continuing with Wi-Fi setup.
If a paired machine starts with no usable network—for example, after its Wi-Fi password changes—it waits about two minutes and then opens 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.
Removing a machine makes its existing app access and identity unusable. Do not remove it just to fix Wi-Fi or replace a printer.
Remove device marks the machine Decommissioned and tells it to wipe its pairing. A machine that is powered on and online does this within about a minute, then comes back on its own 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 raises Stardeck-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 onto Stardeck-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.
A hand reset cannot be undone from the machine. Pairing it again needs a fresh pairing code from your dashboard.
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.
If the machine is on a network you can reach but is physically awkward to get to, its setup page offers the same Factory reset under Diagnostics, confirmed with the machine’s serial number. Ten wrong serials pause that for a minute, then it accepts attempts again.