Installation unattended robot

An unattended robot runs automated processes without human help. You can install one on a virtual machine (VM) to run tasks in the background.

What You'll Need

• Access to Robotiq.ai Headquarters (HQ)
• A virtual machine (VM)
• Administrator rights on the VM
• Secure Sign-In (Ctrl + Alt + Delete) turned off on the VM

How to Install an Unattended Robot

Step 1: Prepare Your Virtual Machine

1. Turn off Secure Sign-In (Ctrl + Alt + Delete) on your robot VM.
2. Restart the VM after turning off Secure Sign-In.
3. Check that your VM meets the Robotiq.ai VM requirements.

Step 2: Download the Robot Installer

1. Log in to Robotiq.ai HQ.
2. In the left menu, click Settings.
3. Click Robots.
4. Click the Download robot button.
   • This download might take a few minutes.
   • Robotiq.ai suggests using the Chrome browser for the download.
   • If you have trouble opening the .msi file from your browser's recent downloads, look for it in your Windows user downloads folder (for example, C:\Users\{Username}\Downloads\).

Important: If you have an older robot installation, uninstall it before you continue.

Step 3: Start the Installation Wizard

1. Double-click the downloaded .msi file to open the installation wizard.
2. If a "Windows protected your PC" pop-up shows up, click More info, then Run anyway.
3. Click Next to start the RecorderRobotSetup.msi Wizard.
4. Agree to the terms in the "End-User License Agreement" and click Next.
5. Pick your installation folder and click Next.
6. Choose the Unattended Robot option and click Next.

Step 4: Set Up Robot Details

1. In the new window, the "HQ Server" and "SSO Server" fields will fill in by themselves. Don't change them.
2. Add the following information:
   • Tenant Name: Find this in HQ by going to Settings > Tenant. Use the exact tenant name from your HQ URL (for example, https://tenantname.headquarters.robotiq.ai/).
   • Client ID: You'll get this after adding a new robot in HQ.
   • Client Secret: You'll get this after adding a new robot in HQ.

Important: Don't close the Setup Wizard yet.

Step 5: Add a New Robot in HQ

1. Go back to Robotiq.ai HQ.
2. In the left menu, click Settings.
3. Click Robots.
4. Click the Add robot button.
5. Enter the necessary information for your robot.
6. Click Save.
7. A pop-up with Client information will appear. This has the Client ID and Client Secret you need for the Setup Wizard.
   • Use the copy button next to each field to copy the information.
   • The client secret works only once. If you need a new one, you can regenerate it.

Step 6: Finish the Installation Wizard

1. Go back to the Setup Wizard.
2. Fill in the Client ID and Client Secret you copied from HQ.
3. Click Next.
4. Enter the Username and Password the robot will use to log in to the VM.
   • If you use a domain for VM login (for example, companydomain\robotUser), include the domain in the Username.
5. Choose one of the three options for administrator rights. Provide admin details if needed.
   • If you give an admin role, Robotiq.ai suggests installing the Robot Monitoring Tool separately. This lets you update the robot from HQ.
6. Click Next.
7. Click Install.
8. When asked, click Yes to let the publisher make changes to your device.
9. Click Finish.

Step 7: Check the Installation

1. Go to Robotiq.ai HQ.
2. Check the Robots page to see if your robot is listed with the status "Available".
3. If the status is "Available", you can sign out from the user session on the VM.
4. If the status is not "Available", restart the VM. If the problem continues, uninstall and reinstall the robot.
5. To make sure the robot is working, schedule a job to run right away (for example, a Pause Step) on a department assigned to the robot. Make sure you are logged out of the robot's VM session.

Related Articles

• Requirements for robot VM
• Regenerate Token
• Robot Monitoring Tool

Need Help?

Can't find what you're looking for? Join the Robotiq Community to get help from other users and the Robotiq team.