Previous
Configure machine settings
This page will guide you to connect your machine to a different WiFi network.
Should your machine be able to connect to multiple networks?
Can your machine still connect to the old network?
Your machine must have viam-agent
installed to be able to configure network settings.
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.
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 again using the force provisioning mode.
If you can manually SSH
into a machine you can follow these steps:
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.
Open a shell on your machine:
viam machines part shell --part <PART-ID>
On the machine, create an empty file at
touch /opt/viam/etc/force_provisioning_mode
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
Follow the instructions to complete end-user setup for a machine and configure the new network settings.
Was this page helpful?
Glad to hear it! If you have any other feedback please let us know:
We're sorry about that. To help us improve, please tell us what we can do better:
Thank you!