This is a guide on how to fix a device not checking in.
If a device hasn't checked in on the Computers page for more than 24 hours and has been on and connected to the internet, you'll want to try the steps below to resolve this issue.
Procedure
If a device isn't checking in, you'll want to try an agent reset:
Mac
- Open terminal (easiest way is cmd + space bar & search for 'terminal')
- Copy/Paste
sudo /usr/local/vanta/vanta-cli reset
- Hit 'Return'. It may ask you for a password (use the password you have to download apps or to open your computer)
Windows
- Search for cmd.exe in the search bar. Right-click and select “run as administrator.”
- Type
C:\PROGRA~1\Vanta\vanta-cli reset
and pressreturn
Linux
- Open terminal
- Copy/Paste
sudo /var/vanta/vanta-cli reset
- Hit 'Return'. It may ask you for a password (use the password you have to download apps or to open your computer)
Common Issues
If the device still doesn't check in within 24 hours of running the reset command, we recommend uninstalling and reinstalling the agent.
Mac uninstall/reinstall
- Open Terminal (easiest way to find it is cmd+space bar "terminal")
- Copy and paste the code below into the Terminal:
sudo /usr/local/vanta/vanta-cli uninstall
- To reinstall, please visit https://app.vanta.com/download
Windows uninstall/reinstall
- Go to Apps & Features, search for Vanta, and click the Uninstall button.
- Delete the files in the Vanta folder from this location C:\ProgramData\Vanta.
- Please reboot your machine before attempting to reinstall
- To reinstall, please visit https://app.vanta.com/download.
Linux uninstall/reinstall
- Open the command line, and run
sudo vanta-cli uninstall
- To reinstall, please visit https://app.vanta.com/download
If the Agent still fails to check in a few hours after trying this, please run our diagnostic tool, doctor, and copy the full output to share with the Vanta support team:
Mac
- Open terminal (easiest way is cmd + space bar & search for 'terminal')
- Copy/Paste
sudo /usr/local/vanta/vanta-cli doctor
- Hit 'Return'. It may ask you for a password (use the password you have to download apps or to open your computer)
Windows
- Search for cmd.exe in the search bar. Right-click and select “run as administrator.”
- Type
C:\PROGRA~1\Vanta\vanta-cli doctor
and pressreturn
Linux
- Open terminal
- Copy/Paste
sudo /var/vanta/vanta-cli doctor
- Hit 'Return'. It may ask you for a password (use the password you have to download apps or to open your computer)