Installing and linking Robocorp App

Downloading the latest version of Robocorp App

  1. While logged into Robocorp Cloud, click on the Environments menu item in the top bar. Open Environments screen in Robocorp Cloud
  2. In the Environments screen, select the correct installation package for your Operating System and download it: Robocorp App download links in Robocorp Cloud

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 App - Accepting the software license agreement

  3. Choose whether you want to install for your user only or for all users on the machine, in which case you will be asked for admin credentials.

  4. Choose the installation location.

  5. Wait for the installer to complete.

  6. Finish the installation.

    Robocorp App - Finish installation

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 App - Select the operating system to download
  3. In the next window, drag the Robocorp App icon into the Applications folder shortcut: Robocorp App - Dragging to application folder
  4. Find the Robocorp App icon in your Application folder and launch it by double-clicking on it.

Now you are ready to link and start your Robocorp App.

Installation under Linux

  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): click on the right mouse button on the downloaded file, select Properties, switch to the Permissions tab, and select the Allow executing file as program checkbox. You can now close the dialog.

      Robocorp App 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 robocorp-app-linux.AppImage

  3. Run the robocorp-app-linux.AppImage file either by double-clicking on it or via the Terminal.

  4. Read and accept the Software License Agreement:

    Robocorp App accepting software license agreement

  5. The application will start.

Now you are ready to link and start your Robocorp App.

Before Robocorp App can start executing your workforce processes, you need to link it to Robocorp Cloud.

You can do it in two ways, either using your Robocorp Cloud credentials, or by providing it with an access token. This procedure is the same for all platform versions.

Linking Robocorp App using your Robocorp Cloud Credentials

  1. Select Robot Workforce in the start screen: Robocorp App - Choose workforce
  2. Click on the Login to Robocorp Cloud button in the main screen in Robocorp App: Robocorp App - Linking with credentials
  3. You will see the familiar Robocorp Cloud login screen. Log into Robocorp Cloud with your credentials. Robocorp App - Linking with credentials - Login
  4. Choose the workspace you want to associate Robocorp App with: Robocorp App - Linking with credentials - Choose workspace
  5. Give a name to your Robocorp App and confirm by clicking the Link Robocorp App button: Robocorp App - Linking with credentials - Give a name to Robocorp App
  6. Your Robocorp App is now linked.

Linking Robocorp App using an access token

  1. In Robocorp Cloud, switch to the workspace you want to link Robocorp App to.
  2. Click on the Environments menu item in the top bar: Open Environments screen in Robocorp Cloud
  3. Click on the Generate link token button: Click generate link token button
  4. A token will be generated and displayed for you. Copy it to the clipboard: View and copy token
  5. In Robocorp App, click on the Link Token tab, paste your token in the Robocorp Cloud Link Token field, and assign a name to the Robocorp App: Provide token to Robocorp App
  6. Your Robocorp App is now linked.

Successfully linked Robocorp Apps displayed in Robocorp Cloud

Once Robocorp App is linked, it will be displayed in the Environments page of the relevant workspace:

Robocorp App in the Robocorp Cloud UI

Your Robocorp App is now ready to be assigned to your robots.

Follow the instructions on the Using Robot Assistants in Robocorp Cloud page.

Starting and stopping Robocorp App

Once you have linked Robocorp App to Robocorp Cloud, you can start it and stop using the UI. You can check the console output log on the main screen. Robocorp App start and stop

Unlinking a linked Robocorp App

To unlink a linked Robocorp App:

  1. Click on the dropdown on the top right, and select Unlink Environment: Unlink Robocorp App
  2. Confirm in the next screen: Confirm Robocorp App unlinking
  3. Robocorp App is now unlinked.

Once you have unlinked Robocorp App, you can link it again, but it will be considered a new Runtime Environment in Robocorp Cloud, and you will need to clear the old Environment from Robocorp Cloud manually.