Connect a machine to a new network

This page will guide you to connect your machine to a new WiFi network.

Prerequisites

Your machine must have viam-agent installed to be able to configure network settings.

Connect to a different WiFi network

As your machine boots, viam-agent checks for known networks, if none can be found, viam-agent automatically enters provisioning mode.

Follow the instructions to complete end-user setup for a machine and configure the new network settings.

Force provisioning mode

If you want to change the WiFi network or the network credentials on a device that is already setup and can still connect to the current network, you can enter provisioning using the force provisioning mode.

If you can manually SSH into a machine you can follow these steps:

1. Add the ViamShellDanger fragment. The ViamShellDanger fragment contains the latest version of the shell service, which you must add to your machine before you can use the viam machines part shell command.

2. Open a shell on your machine:

   viam machines part shell --part <PART-ID>
   

3. On the machine, create an empty file at /opt/viam/etc/force_provisioning_mode:

   touch /opt/viam/etc/force_provisioning_mode
   

4. The machine will immediately enter provisioning mode until the machine receives the new credentials or the retry_connection_timeout_minutes limit, by default 10 minutes, expires.

If you created a provisioning app, program it to add an empty file at /opt/viam/etc/force_provisioning_mode.

Follow the instructions to complete end-user setup for a machine and configure the new network settings.

Connect to multiple networks

If your machine frequently moves between different WiFi networks, you can add the credentials for additional networks in the machine settings. Your machine must still be internet-connected for this configuration to take effect.