From 4f1e6b6a42d41a5b9752fae89a48d6e17dda8b93 Mon Sep 17 00:00:00 2001 From: Retroqd Date: Sun, 24 May 2026 14:19:47 +0530 Subject: [PATCH] docs: warn about missing noble-updates/backports on Ubuntu 24 installs (#6854) (cherry picked from commit 36e5fd66942c2a5111986a4053efc31edaf3573f) --- source/Installation/Ubuntu-Install-Debs.rst | 23 +++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/source/Installation/Ubuntu-Install-Debs.rst b/source/Installation/Ubuntu-Install-Debs.rst index c79f23d72a5..2b152775628 100644 --- a/source/Installation/Ubuntu-Install-Debs.rst +++ b/source/Installation/Ubuntu-Install-Debs.rst @@ -42,6 +42,29 @@ Install development tools (optional) If you are going to build ROS packages or otherwise do development, you can also install the development tools: +.. warning:: + + On Ubuntu 24.04 installs your apt sources may only include the base ``noble`` suite. + This can cause dependency conflicts when installing ``ros-dev-tools``. + + Check ``/etc/apt/sources.list.d/ubuntu.sources`` and ensure the ``Suites:`` line includes ``noble-updates`` and ``noble-backports``: + + .. code-block:: console + + $ grep Suites /etc/apt/sources.list.d/ubuntu.sources + + If ``noble-updates`` or ``noble-backports`` are missing then edit the file and update the line to: + + .. code-block:: text + + Suites: noble noble-updates noble-backports + + Then run: + + .. code-block:: console + + $ sudo apt clean && sudo apt update && sudo apt full-upgrade -y + .. code-block:: console $ sudo apt update && sudo apt install ros-dev-tools