LGDXRobot Cloud is a robot management system for Automated Guided Vehicles (AGVs), designed with a focus on flexibility and security. It can monitor the status of robots in real-time and manage automated tasks for transportation and logistics. The system is also designed to support easy integration with third-party services and workflows. It integrates seamlessly with the LGDXRobot2 robot, as well as open integrations with any ROS 2-compatible robot with LGDXRobot Cloud Adapter.
- Homepage
- Documentation
- Issue boards on both GitLab and GitHub
- Real-Time Management: Manage robot statuses and task processes through a real-time web interface.
- United Solution Setup: Generate maps with SLAM, register robots, and manage operations using the same system.
- Multi-Fleet Management: Manage multiple fleets of robots with waypoint navigation and traffic control.
- Email Notifications: Receive notifications for incidents and alerts, with customisable recipients.
- Seamless Integration: Customisable workflows allow integration with third-party web services and hardware.
- User Management: Create users and define permissions based on roles or fine-grained access control.
- Security Features:
- Two-factor authentication with a mobile app for user login.
- Certificate-based authentication for robots.
- Optional hardware-level protection via serial number validation.
- API Key Management: Manage API keys to control third-party service access to the system.
Monitor robot locations on a map, highlighting the selected robot along with its status and planned path.
Monitor robot statuses on a page.
Generate maps using SLAM.
The system is built using the .NET, with ASP.NET Web API for the backend and Blazor for the frontend.
It also utilises RabbitMQ for reliable message queuing to the worker service, Redis for robot data aggregation, and PostgreSQL for database management.
Communication between the system and the robot is handled using gRPC.
The solution consists of the following projects:
LGDXRobotCloud.API: Backend API for data management, task distribution, and access controlLGDXRobotCloud.UI: Frontend project providing a real-time user interfaceLGDXRobotCloud.Worker: Background services for time-consuming tasks such as sending email notifications or calling external APIsLGDXRobotCloud.Data: Contains database schema definitions and migrations, as well as Data Transfer Objects (DTOs) and internal modelsLGDXRobotCloud.Utilities: Common functions and constants shared across other projects
For users who want to set up and customise the system for their specific needs.
https://docs.lgdxrobot.bristolgram.uk/cloud/
For users who want to get up and running quickly with the system only.
LGDXRobot Cloud includes a Docker/docker-compose setup for easy deployment in development and testing environments. You will need Docker with Docker Compose, Git, and OpenSSL installed.
To get started:
cd Docker/docker-compose/certs
# Option 1: Run the script to generate the certificates
# Option 2: Run the commands manually in the script
chmod +x ./generate-certs.sh
./generate-certs.shAfter running the script, the console will display the serial number/thumbprint of the certificate. Copy the value (after the = symbol) and paste it into the relevant appsettings.json files in the Docker/docker-compose folder.
Then, start the environment:
cd ..
docker-compose upWait for the console to display the message: data-1 exited with code 0. This indicates that the database has been initialised and the API is ready. Alternatively, you can check whether the docker-compose-data-1 container has terminated.
To access the frontend, open: https://localhost:5103/
The default username and password is admin / 123456.
To pull the image from Docker Hub, you can either use the latest tag or specify a particular version number, such as 1.0.0. Please refer to the Releases page for the version history. All images support both amd64 and arm64 architectures.
This project is licensed under the MIT Licence.
API client generation relies on Kiota. To generate the client for the LGDXRobotCloud.UI project, with the LGDXRobotCloud.API project running, use the following command:
kiota generate -l CSharp -c LgdxApiClient -n LGDXRobotCloud.UI.Client -o ./Client -d https://localhost:5163/openapi/v1.json --clean-output