How to enroll the agent, when faced with the error message "Agent is not enrolled"

  • Updated


This is a guide on how to enrol the agent when faced with the error "Agent is not enrolled" when running the doctor command.



  • When troubleshooting the Vanta Agent, running the built-in troubleshooting tool called doctor returns the following error message:
    Running checkup: Check Vanta endpoint metadata
    ERROR: Agent is not enrolled.
    X Checkup failed. See above for what went wrong.
  • Your company's Vanta Key (Only Vanta admins and editors have access to this information within Vanta)


  1. Make sure you are getting the "Agent is not enrolled" message when running the doctor command prompt.
    To run the doctor:

    • 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 hit 'Return'


  2. Locate the company's Vanta Key, This can be provided to you by your admin.
    • Vanta Admin can locate the key within Vanta using the following steps: 
      • Navigate to the Computers Page
      • Click on the Unmonitored Tab
      • Click on View Setup Instructions
      • Click on Option 3: MDM and Vanta Agent
      • Look for the phrase VANTA_KEY

  3. Run the below command prompt in your terminal, replacing 'VANTA_KEY' with the key from the previous step, and 'YOUR_EMAIL' with the email for the device's primary user:
    C:\PROGRA~1\Vanta\vanta-cli register --secret=VANTA_KEY --email=YOUR_EMAIL

    - For example:

    C:\PROGRA~1\Vanta\vanta-cli register --secret=1232131231asdasd


Was this article helpful?

Have more questions? Submit a request