Edit

Manage viam-agent

viam-agent is installed as a systemd service named viam-agent.

Linux
Windows native

To restart viam-agent:

Alert

When you restart viam-agent, the agent will restart viam-server as well.

Web UI
Shell

Navigate to your machine in Viam.
Click on the machine status indicator next to the machine name.
Click on the restart arrow symbol. This will restart viam-server and viam-agent.

sudo systemctl restart viam-agent

To start viam-agent:
```
sudo systemctl start viam-agent
```
To stop viam-agent:

Alert

When you stop viam-agent, the agent will stop viam-server as well.

sudo systemctl stop viam-agent

To completely uninstall viam-agent and viam-server, run the following command:
```
sudo /bin/sh -c "$(curl -fsSL https://storage.googleapis.com/packages.viam.com/apps/viam-agent/uninstall.sh)"
```
This command uninstalls viam-agent, viam-server, the machine cloud credentials file (/etc/viam.json), and the provisioning configuration file (/etc/viam-provisioning.json).

Caution

If you remove the machine cloud credentials file you will not be able to connect to your machine. You can only restore this file if you have access to the machine configuration.

On Windows, you can manage viam-agent using the Services GUI or the command line. You can also use the Viam web UI to restart viam-agent.

Open the Services management console from your computer’s start menu.
Find viam-agent in the list of services.
Use the Restart Service, Stop Service, and Start Service buttons to manage viam-agent.
To change the startup type of viam-agent, right-click on viam-agent and select Properties. Select your desired startup type from the Startup type dropdown menu.

Open a PowerShell prompt, selecting Run as administrator.

Use the following commands to manage viam-agent:

To start viam-agent:
```
Start-Service viam-agent
```
To stop viam-agent:
```
Stop-Service viam-agent
```
To restart viam-agent:
```
Restart-Service viam-agent
```

To change the startup type of viam-agent, use one of the following commands:

Set-Service -Name "viam-agent" -StartupType Manual
Set-Service -Name "viam-agent" -StartupType Automatic

Navigate to your machine in Viam.
Click on the machine status indicator next to the machine name.
Click on the restart arrow symbol. This will restart viam-server and viam-agent.

To uninstall viam-agent, run the following command in an administrator prompt:

sc stop viam-agent
sc delete viam-agent
Remove-Item \opt\viam -Recurse
Remove-Item C:\Windows\system32\config\systemprofile\.viam -Recurse

Troubleshooting

You can find assistance in the Troubleshooting section.

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!