LGDXRobot Logo
  1. Home
  2. LGDXRobot Cloud
  3. Getting Started

Getting Started

This section explains how to set up LGDXRobot Cloud, configure the map and workflow, and then start the first automation job. This tutorial is suitable for both physical and simulated robots, and it uses the LGDXRobot2 Docker image.

Prerequisites

Physical Robot

  • A LGDXRobot2 robot.
  • The robot’s onboard computer has LGDXRobot2 ROS 2 installed

Simulation Robot

  • Webots
  • Docker
  • Docker is running the LGDXRobot2 ROS 2 Docker image

Step 1: Create a Folders

Create a folder to store the certificates. For the simulation, create an additional folder to share the Webots files.

Step 2: Run the Docker Image

For the desktop image, access the web interface at http://localhost:3000/ or at https://<ip>:3001 for a remote computer. If the terminal is closed, right-click on the desktop and relaunch it from the menu.

Physical Robot

docker run -d \
  --name lgdxrobot2 \
  -v <path to certificates folder>:/config/keys \
  -v /dev:/dev \
  --device-cgroup-rule='c 81:* rwm' \
  --device-cgroup-rule='c 189:* rwm' \
  --device-cgroup-rule='c 188:* rwm' \
  --device-cgroup-rule='c 166:* rwm' \
  --device-cgroup-rule='c 13:* rwm' \
  --privileged \
  -e PUID=1000 \
  -e PGID=1000 \
  -p 3000:3000 \
  -p 3001:3001 \
  yukaitung/lgdxrobot2-desktop:latest

Simulation Robot

  1. Save the local simulation server script on the host computer.
  2. Define WEBOTS_HOME environment variable.
  3. Run the simulation server.
python3 <path>/local_simulation_server.py
  1. Run the LGDXRobot2 ROS 2 Docker image.
docker run --rm -it \
  -e PUID=1000 \
  -e PGID=1000 \
  -v <path to certificates folder>:/config/keys \
  -v <path to Webots share folder>:/config/share \
  -p 3000:3000 \
  -p 3001:3001 yukaitung/lgdxrobot2.desktop:latest
  1. Access the web interface at http://localhost:3000/
  2. On the terminal, set the environment variable:
export WEBOTS_SHARED_FOLDER=<path to Webots share folder>:/config/share

Click the blue button in the middle-left to expand the settings. Paste the command into the Clipboard section, then paste it directly into the terminal.

When running the simulation, the Webots GUI opens automatically on the host machine.