Fix a device's network

If a device set up from the Suta image can’t reach the internet, for example after a Wi-Fi password change, you can fix it from a computer nearby. The device keeps its owner and identity throughout.

Note

This guide is for devices set up from the Suta image. A Pi where you installed Suta on an existing system keeps its own network tools; change its network settings the way you normally would.

Before you begin

• You need the Configure networking permission in the workspace that owns the device. See Roles and permissions.
• Your computer needs internet access, and must be close enough for Bluetooth or on the same local network as the device.

Repair the network

1. On the device, open a 15-minute repair window. Use a keyboard and screen, or an SSH session if one still works:

   sudo suta setup

2. On your computer, run:

   suta device network kitchen-pi

   Replace kitchen-pi with the device’s name or ID.

3. Choose the device when the CLI finds it, then update its Wi-Fi or Ethernet settings.

The CLI checks that the device it finds has the key it expects, so it never changes the wrong device. If a new Wi-Fi setting fails, the device goes back to its previous connection.

Things that don’t affect ownership

Rebooting, entering a wrong Wi-Fi password and unplugging Ethernet all leave the device’s owner unchanged. Only reflashing the SD card creates a new identity.

If the repair permission expires before you finish, run suta device network again to get a fresh one.