Webinar

November 3rd, 2021 12:00 PM EDT
Automation for Field Services & DistributionNovember 3rd, 2021 12:00 PM EDT
Learn how creating a digital workforce can improve your supply chain processes!

Installing Robocorp Lab

Download the latest version of Robocorp Lab

Go to the Robocorp Lab download page and download Robocorp Lab for your operating system.

Installation under Windows

  1. Find the .exe version of the installer you downloaded on your machine and execute it.
  2. Read and accept the Software License Agreement
  3. Wait for the installer to complete.
  4. Robocorp Lab will be launched for the first time. During the first launch, the environment will be set up for you. This operation may take several minutes.
  5. After the initial setup is done, you will be taken to the startup screen.

Installation under macOS

  1. Find the .dmg version of the installer you downloaded on your machine and launch it.

  2. Read and accept the Software License Agreement.

  3. In the next window, drag the Robocorp Lab icon into the Applications folder shortcut:

    Robocorp Lab dragging to application folder

  4. Find the Robocorp Lab icon in your Application folder and launch it by double-clicking on it. During the first launch, the environment will be set up for you. This operation may take several minutes.

  5. After the initial setup is done, you will be taken to the startup screen.

Installation under Linux

Robocorp Lab for Linux is distributed as an AppImage package.
We recommended setting up desktop integration for AppImage.

  1. Find the .AppImage version of the installer you downloaded on your machine.

  2. Make the downloaded file executable. You can do it in two ways:

    • Via the UI (Gnome): Right-click on the downloaded file, select Properties, switch to the Permissions tab, and select the Allow executing file as program checkbox. Close the dialog.

      Robocorp Lab Linux set package executable

    • Via the Terminal: Open a terminal, change to the directory containing the AppImage file, e.g., using cd <my directory>, and execute the command chmod +x Robocode\ Lab.AppImage

  3. Run the Robocorp Lab.AppImage file either by double-clicking on it or via the Terminal.

  4. Read and accept the Software License Agreement.

  5. The application will start. During the first launch, the environment will be set up for you. This operation may take several minutes.

  6. After the initial setup is done, you will be taken to the startup screen.

Start using Robocorp Lab

That's it! Now you can start using Robocorp Lab to create, develop and run your robots.

Robocorp Lab log file locations

Robocorp Lab log files help the development team with resolving unexpected issues. Here are the log file locations:

Windows

%USERPROFILE%\AppData\Local\robocorp\RobocodeLab\log\

macOS and Linux

~/.robocorp/RobocodeLab/log/

Uninstalling Robocorp Lab

If you have linked Robocorp Lab to Control Room, a programmatic access key has been created in Control Room. You can unlink Robocorp Lab from the application itself or remove the access keys from your Robocorp account at https://cloud.robocorp.com/settings/access-credentials.

robocorp-lab-unlink.png

Uninstalling Robocorp Lab consists of:

  1. Uninstalling the application.
  2. Removing all data generated by Robocorp Lab.

Uninstalling the application

  • On Windows:
    1. Go to Apps & features under system settings.
    2. Select Robocorp Lab from the list and press Uninstall.
  • On macOS:
    1. Open Finder and find Robocorp Lab under the Applications folder.
    2. Right-click on the application name and select Move to Bin.
  • On Linux:
    1. Find the Robocorp Lab .appImage file on your system and delete it.

Removing data generated by Robocorp Lab and RCC

Before deleting anything, please note:

The data folder is shared and used by Robocorp applications (RCC, Assistant, Workforce Agent, and the VS Code extension). If you want to remove everything, you can delete the entire folder.

Robocorp Lab stores data files under a common folder according to OS conventions. The folder holds the cache for environments, logs, and the data that links your Robocorp Lab to Control Room.

  • On Windows, find this in: %USERPROFILE%\AppData\Local\robocorp\
    • Copy & paste to File Explorer address bar.
  • On macOS and Linux in: ~/.robocorp/
    • On macOS: Go -> Go to Folder -> write ~/.robocorp/.
    • On Linux... just go there ;)

One more choice before clearing:

  • If you are NOT using any other Robocorp tools (Robocorp Assistant, Robocorp Workforce Agent or Robocorp Code):
    ...and just want to clean everything --> You can delete the whole folder

  • If you ARE using other Robocorp tools and want to keep using it:
    --> You should only delete the /RobocodeLab folder

Installation issues

  • On Windows, files can get locked (e.g., a chromedriver process attached to a file). Try rebooting the computer.
  • Existing JupyterLab installation may interfere with installing Robocorp Lab. To avoid issues, uninstall JupyterLab before installing Robocorp Lab.
  • On Windows, the filename length limit can cause installation failures. See the troubleshooting guide for how to fix this.
September 14, 2021