Ubuntu 24.04
============

.. meta::
   :description: Migrate a Neobotix robot PC to Ubuntu 24.04 and ROS 2 Jazzy,
                 install the robot setup tools, and configure remote access.

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

==================== =============
Ubuntu version       ROS 2 distro
==================== =============
24.04 (Noble)        Jazzy
==================== =============

This guide uses `Xubuntu <https://xubuntu.org/>`_, a lightweight Ubuntu flavor
that is well suited to older robot PCs.

.. _robot-setup-tools:

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.

1. Download Xubuntu 24.04 from the `official Xubuntu website
   <https://xubuntu.org/download/>`_ and install it on the robot PC.
2. Visit the `robot-setup-tool repository
   <https://github.com/neobotix/robot-setup-tool>`_ 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:

   .. code-block:: bash

      git clone https://github.com/neobotix/robot-setup-tool.git
      cd robot-setup-tool
      git checkout noble
      cd debian
      ./make_deb.sh

3. Install the resulting ``.deb`` package:

   .. code-block:: bash

      sudo apt install ./neobotix-tools.deb

   During installation, you will be prompted to enter a VNC password.

Restart the robot when prompted. Then follow :ref:`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 <https://ubuntu.com/tutorials/install-ubuntu-desktop>`_
for operating-system installation instructions.

Follow :ref:`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
   <https://gitlab.gnome.org/Archive/vino>`_ runs on the robot. After the robot
   boots, connect using a VNC client such as `Remmina <https://remmina.org/>`_
   on Linux or `SSVNC <https://sourceforge.net/projects/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
<https://neobotix-docs.de/hardware/en/platforms/first-steps/index.html#remote-desktop-connection-vnc>`_.

X2Go
####

1. On Windows or macOS, download the X2Go client from the `official X2Go
   website <https://wiki.x2go.org/doku.php/download:start>`_. On Ubuntu,
   install it with:

   .. code-block:: bash

      sudo apt install x2goclient

2. Open X2Go Client from the application menu or run ``x2goclient``.
3. Select **Session → New session**.
4. Enter the IP address of the robot PC as the host.
5. Enter the username configured during the Xubuntu installation.
6. Select **X2Go/X11 Desktop sharing** as the session type and confirm the
   settings.
7. Select the new session from the sessions panel.
8. Enter the login credentials and connect.
9. Select **Full Access** in the remote-desktop sharing dialog.