Ubuntu 24.04¶

As of September 2026, Neobotix supports ROS 2 Jazzy on Ubuntu 24.04. See Installation for the general ROS 2 installation instructions.

Ubuntu version	ROS 2 distro
24.04 (Noble)	Jazzy

This guide uses Xubuntu, a lightweight Ubuntu flavor that is well suited to older robot PCs.

Installation on the robot PC¶

Follow these steps to migrate the robot PC to Ubuntu 24.04 and ROS 2 Jazzy.

Note

To preserve the existing installation and robot-specific parameters, keep the old SSD or HDD as a backup and install Ubuntu 24.04 on a new drive.

Download Xubuntu 24.04 from the official Xubuntu website and install it on the robot PC.
Visit the robot-setup-tool repository and select Actions → Build debian package. Download the Debian package artifact from a recent successful workflow run.

Alternatively, build the package locally from the noble branch:
```
git clone https://github.com/neobotix/robot-setup-tool.git
cd robot-setup-tool
git checkout noble
cd debian
./make_deb.sh
```
Install the resulting .deb package:
```
sudo apt install ./neobotix-tools.deb
```
During installation, you will be prompted to enter a VNC password.

Restart the robot when prompted. Then follow Installation, beginning with the Packages for Robot-PC section, to install the robot packages.

Installation on the client PC¶

Install Ubuntu 24.04 and ROS 2 Jazzy on the client PC as well. Any Ubuntu flavor can be used because the client PC is primarily used for visualization and monitoring with tools such as RViz and PlotJuggler. See the official Ubuntu installation tutorial for operating-system installation instructions.

Follow Installation, beginning with the Packages for Client-PC section, to install the required client packages.

Remote desktop access¶

The Neobotix Debian package configures the robot PC for remote access. You can connect using VNC or X2Go.

Note

A preconfigured Vino VNC server runs on the robot. After the robot boots, connect using a VNC client such as Remmina on Linux or SSVNC on Windows.

VNC is easy to use on a reliable network, but its performance, encryption, and functionality can be limited. Use X2Go if you need encrypted transfer or additional remote-desktop features.

Remmina¶

See the Remmina setup guide in the Neobotix hardware documentation.

X2Go¶

On Windows or macOS, download the X2Go client from the official X2Go website. On Ubuntu, install it with:
```
sudo apt install x2goclient
```
Open X2Go Client from the application menu or run x2goclient.
Select Session → New session.
Enter the IP address of the robot PC as the host.
Enter the username configured during the Xubuntu installation.
Select X2Go/X11 Desktop sharing as the session type and confirm the settings.
Select the new session from the sessions panel.
Enter the login credentials and connect.
Select Full Access in the remote-desktop sharing dialog.