Skip to main content

Upgrading to Ubuntu 24.04

Overview​

This guide explains how to upgrade an existing Ubuntu 22.04 based Cloudron to Ubuntu 24.04 (noble numbat). 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:

  • Cloudron must be on at least version 8.0. Verify in the Settings view. Cloudron releases prior to 8.0 do not support Ubuntu 24.04.
  • Ubuntu must be on version 22.04. Check with lsb_release -a.
  • The upgrade takes 1-3 hours depending on network, CPU, and disk speed.

Pre-flight​

Create a server snapshot for quick rollback before starting. 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 Ubuntu 24.04 in output:
    bash
    lsb_release -a
  2. Verify active (running) status:
    bash
    systemctl status box
  3. Verify active (running) status:
    bash
    systemctl status unbound
  4. Verify all services in the Services view of the Cloudron dashboard are running.
Upgrade Successful

If all steps above are confirmed, you have successfully upgraded from Ubuntu 22 to Ubuntu 24.