Skip to main content

Upgrading to Ubuntu 24.04 (noble numbat)

Overview​

This guide explains how to upgrade an existing Ubuntu 22.04 based Cloudron to Ubuntu 24.04. Upgrade to Ubuntu 22 first using this guide if still on Ubuntu 20.

Ubuntu 22.04 is supported by Canonical until 2027. Cloudron supports both Ubuntu 22.04 and 24.04 with the same feature set.

Checklist​

Before upgrading, please note the following:

  • Cloudron must be on at least version 8.0. Verify this by checking the version in the Settings view. Cloudron releases prior to 8.0 do not support Ubuntu 24.04.
  • Ubuntu must be on version 22.04. Check the output of lsb_release -a to confirm this.
  • The upgrade takes around 1-3 hours based on various factors like network/cpu/disk etc

Pre-flight​

Create a server snapshot for quick rollback before starting the upgrade. If your VPS lacks snapshotting, create a full Cloudron backup first (Backups -> Create Backup now).

Highly recommend taking server snapshot

A server snapshot saves trouble if the server fails to start after the upgrade. If your VPS provider lacks snapshots, keep backups outside your server. In some cases, Ubuntu fails to boot entirely, locking your data and backups inside the server disk.

Upgrading​

Run the upgrade:

bash
dpkg --configure -a
apt update
apt upgrade
do-release-upgrade

Upgrade notes:

  • Accept running an additional SSH daemon at port 1022.
  • Choose 'yes' to restart services without asking.
  • For all packages (mime, nginx, timesyncd, logrotate, journald, etc.), select N or O to keep your currently-installed version (default).

Restart the server after the upgrade completes.

Post upgrade​

Version older than Cloudron 9

With Cloudron 9, collectd was removed. Skip this step for Cloudron 9+.

Fix collectd: /etc/default/collectd may have an LD_PRELOAD line from previous releases. After any changes, restart collectd: systemctl restart collectd

/etc/default/collectd
# DELETE THIS LINE OR EQUIVALENT
LD_PRELOAD=/usr/lib/python3.10/config-3.10-x86_64-linux-gnu/libpython3.10.so
  • Install unbound-anchor (not installed automatically on some VPS):
Bash
apt install unbound-anchor

Post upgrade checks​

  1. Verify that the output includes Ubuntu 24.04 from running the following command:
    Bash
    lsb_release -a
  2. Verify that the output states active (running) from running the following command:
    bash
    systemctl status box
  3. Verify that the output states active (running) from running the following command:
    Bash
    systemctl status unbound
  4. Verify that all the services in the Services view of Cloudron dashboard are running.
Upgrade Successful

If the above steps are all confirmed, you have successfully upgraded your Ubuntu 22 to Ubuntu 24:::