docs/guides/ubuntu: add Noble (24.04) guide

This update also includes language indicating that the guides provide a minimal installation. Additional packages need to be installed as needed.

(cherry picked from commit 1615c0af2b)

docs/guides/ubuntu.rst

@@ -4,4 +4,5 @@ Ubuntu
 .. toctree::
   :titlesonly:
 
-  ubuntu/uefi
+  ubuntu/jammy-uefi
+  ubuntu/noble-uefi

docs/guides/ubuntu/_include/distro-install-jammy.rst

@@ -107,3 +107,7 @@ Configure packages to customize local and console properties
 .. note::
 
   You should always enable the `en_US.UTF-8` locale because some programs require it.
+
+.. seealso::
+
+  Any additional software should be selected and installed at this point. For a normal desktop experience, install the `ubuntu-desktop` meta package.

docs/guides/ubuntu/_include/distro-install-noble.rst

@@ -0,0 +1,110 @@
+Install Ubuntu
+--------------
+
+.. code-block:: bash
+
+  debootstrap noble /mnt
+
+Copy files into the new install
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. tabs::
+
+  .. group-tab:: Unencrypted
+
+    .. code-block:: bash
+
+      cp /etc/hostid /mnt/etc
+      cp /etc/resolv.conf /mnt/etc
+
+  .. group-tab:: Encrypted
+
+    .. code-block:: bash
+
+      cp /etc/hostid /mnt/etc/hostid
+      cp /etc/resolv.conf /mnt/etc/
+      mkdir /mnt/etc/zfs
+      cp /etc/zfs/zroot.key /mnt/etc/zfs
+
+Chroot into the new OS
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+  mount -t proc proc /mnt/proc
+  mount -t sysfs sys /mnt/sys
+  mount -B /dev /mnt/dev
+  mount -t devpts pts /mnt/dev/pts
+  chroot /mnt /bin/bash
+
+Basic Ubuntu Configuration
+--------------------------
+
+Set a hostname
+~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+  echo 'YOURHOSTNAME' > /etc/hostname
+  echo -e '127.0.1.1\tYOURHOSTNAME' >> /etc/hosts
+
+Set a root password
+~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+  passwd
+
+Configure ``apt``. Use other mirrors if you prefer.
+
+.. code-block:: bash
+
+  cat <<EOF > /etc/apt/sources.list
+  # Uncomment the deb-src entries if you need source packages
+
+  deb http://archive.ubuntu.com/ubuntu/ noble main restricted universe multiverse
+  # deb-src http://archive.ubuntu.com/ubuntu/ noble main restricted universe multiverse
+
+  deb http://archive.ubuntu.com/ubuntu/ noble-updates main restricted universe multiverse
+  # deb-src http://archive.ubuntu.com/ubuntu/ noble-updates main restricted universe multiverse
+
+  deb http://archive.ubuntu.com/ubuntu/ noble-security main restricted universe multiverse
+  # deb-src http://archive.ubuntu.com/ubuntu/ noble-security main restricted universe multiverse
+
+  deb http://archive.ubuntu.com/ubuntu/ noble-backports main restricted universe multiverse
+  # deb-src http://archive.ubuntu.com/ubuntu/ noble-backports main restricted universe multiverse
+  EOF
+
+Update the repository cache and system
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+  apt update
+  apt upgrade
+
+Install additional base packages
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+  apt install --no-install-recommends linux-generic locales keyboard-configuration console-setup
+
+.. note::
+  The `--no-install-recommends` flag is used here to avoid installing recommended, but not strictly needed, packages
+  (including `grub2`).
+
+Configure packages to customize local and console properties
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+  dpkg-reconfigure locales tzdata keyboard-configuration console-setup
+
+.. note::
+
+  You should always enable the `en_US.UTF-8` locale because some programs require it.
+
+.. seealso::
+
+  Any additional software should be selected and installed at this point. For a normal desktop experience, install the `ubuntu-desktop` meta package.

docs/guides/ubuntu/jammy-uefi.rst

@@ -35,7 +35,7 @@ installation using the desktop installer live session.
 
 .. include:: ../_include/update-devices.rst
 
-.. include:: _include/distro-install.rst
+.. include:: _include/distro-install-jammy.rst
 
 .. include:: _include/zfs-config.rst
 

docs/guides/ubuntu/noble-uefi.rst

@@ -0,0 +1,50 @@
+Noble (24.04) UEFI
+==================
+
+.. |distribution| replace:: ubuntu
+
+.. contents:: Contents
+  :depth: 2
+  :local:
+  :backlinks: none
+
+This guide can be used to install Ubuntu onto a single disk with or without ZFS encryption.
+
+The end result will be a pristine Ubuntu install with no GUI or anything other than the base system. You'll be able to
+install `ubuntu-desktop`, `ubuntu-server-minimal` or whatever takes your fancy afterwards.
+
+It assumes the following:
+
+* Your system uses UEFI to boot
+* Your system is x86_64
+* You're mildly comfortable with ZFS, EFI and discovering system facts on your own (``lsblk``, ``dmesg``, ``gdisk``, ...)
+
+Download the latest `Ubuntu Desktop Noble (24.04) Live image <https://ubuntu.com/download/desktop/>`_, write it to a USB drive and
+boot your system in EFI mode. You can use the server installation media if you want, although instructions are provided for
+installation using the desktop installer live session.
+
+.. include:: _include/live-environment.rst
+
+.. include:: ../_include/define-env.rst
+
+.. include:: ../_include/disk-preparation.rst
+
+.. include:: ../_include/pool-creation.rst
+
+.. include:: ../_include/create-filesystems.rst
+
+.. include:: ../_include/update-devices.rst
+
+.. include:: _include/distro-install-noble.rst
+
+.. include:: _include/zfs-config.rst
+
+.. include:: ../_include/zbm-setup.rst
+
+.. include:: ../_include/setup-esp.rst
+
+.. include:: _include/zbm-install.rst
+
+.. include:: _include/efi-boot-method.rst
+
+.. include:: ../_include/cleanup.rst