Skip to main content

Operating System Reinstallation

System reinstallation​

In some cases you will need to restore ROSbot system to its default settings:

  • in case of accidental damage of the system,
  • to update the OS (it can be updated remotely, but flashing the microSD card can be easier sometimes),
  • to clear all user changes and restore factory settings.

This process will differ depending on the single board computer model you have.

Raspberry Pi / Intel NUC / NVIDIA Jetson Orin platforms​

ROSbot XL is fully compatible with Husarion OS. You can locate the available images and follow the installation guide by visiting this page.

Custom SBC / OS Image​

If you use custom user PC or clean Ubuntu Image, it is necessary to customize the OS to work with ROSbot XL.

1. Install Ubuntu Based Image

2. Access Internet connection

3. Robot configs installation

Next install robot configs using:

cd /opt
sudo git clone https://github.com/husarion/robot-configs
sudo ln -s /opt/robot-configs/setup_robot_configuration /usr/local/bin/
sudo setup_robot_configuration rosbot_xl ros2_humble

4. Network Configuration

a. you can use netplan configuration. By modifying /etc/netplan/01-network-manager-all.yaml (change placeholder PLACE_YOUR_WIFI_SSID_HERE and PLACE_YOUR_WIFI_PASSWORD_HERE to correct value).

b. set manually your eth0 connection to 192.168.77.2. This is required to communicate hardware.

5. Docker installation

Use the following commands to install Docker Engine:

sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release
sudo mkdir -m 0755 -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io
sudo groupadd docker
sudo usermod -aG docker $USER

Now install Docker compose v2.16.0:

sudo mkdir -p /usr/local/lib/docker/cli-plugins
sudo curl -SL https://github.com/docker/compose/releases/download/v2.16.0/docker-compose-linux-aarch64 -o /usr/local/lib/docker/cli-plugins/docker-compose
sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose

6. Husarnet installation

Use the following command to install Husarnet:

curl -s https://install.husarnet.com/install.sh | sudo bash
warning

Now reboot to make sure that all changes were applied.

7. Install snaps

Install and configure snaps:

~/factory_reset.sh