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
)
This commit is contained in:
parent
3bf1fc1279
commit
d97f711ed6
|
@ -4,4 +4,5 @@ Ubuntu
|
||||||
.. toctree::
|
.. toctree::
|
||||||
:titlesonly:
|
:titlesonly:
|
||||||
|
|
||||||
ubuntu/uefi
|
ubuntu/jammy-uefi
|
||||||
|
ubuntu/noble-uefi
|
||||||
|
|
|
@ -107,3 +107,7 @@ Configure packages to customize local and console properties
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
You should always enable the `en_US.UTF-8` locale because some programs require it.
|
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.
|
|
@ -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.
|
|
@ -35,7 +35,7 @@ installation using the desktop installer live session.
|
||||||
|
|
||||||
.. include:: ../_include/update-devices.rst
|
.. include:: ../_include/update-devices.rst
|
||||||
|
|
||||||
.. include:: _include/distro-install.rst
|
.. include:: _include/distro-install-jammy.rst
|
||||||
|
|
||||||
.. include:: _include/zfs-config.rst
|
.. include:: _include/zfs-config.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
|
Loading…
Reference in New Issue