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:

    Robocorp Lab accepting 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.

    Robocorp Lab windows startup screen

  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:

    Robocorp Lab accepting 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.

    Robocorp Lab macOS startup screen

  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:

    Robocorp Lab accepting 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.

    Robocorp Lab Linux startup screen

  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 Robocorp Cloud, a programmatic access key has been created in Robocorp Cloud. You can unlink Robocorp Lab from the application itself or remove the access keys from your Robocorp Cloud 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

The data folder is shared and used by RCC and Robocorp App. If you want to remove everything, you can delete the entire folder.

Only the data folder location changes here per operating system; other than that this is just deleting files.

  • Data folder on Windows: %USERPROFILE%\AppData\Local\robocorp\
  • Data folder on macOS & Linux: ~/.robocorp/
  • Items to remove and their purpose:
    • base folder: Environment cache base images created and used by RCC.
    • live folder: Active environment cache created and used by RCC.
    • pipcache folder: Cache for the pip tool used in environment setups created and used by RCC.
    • RobocodeLab folder: Temporary files created by Robocorp Lab.
    • robots folder: Cached robot packages created and used by RCC.
    • wheel folder: Cached wheel files for Robocorp Lab.
    • rcccache.yaml and rcccache.yaml.lock files: Recent robots listing.
    • rcc.yaml and rcc.yaml.lock files: Access credentials to Robocorp Cloud and other RCC related items
      • After deleting these, you need to log into Robocorp Cloud in Robocorp Lab.

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.