Skip to main content

Upgrading to Ubuntu 26.04

Overview​

This guide explains how to upgrade an existing Ubuntu 24.04 based Cloudron to Ubuntu 26.04 (resolute raccoon). Upgrade to Ubuntu 24 first using this guide if still on Ubuntu 22.

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

Checklist​

Before upgrading:

  • Cloudron must be on at least version 10.0.5. Check the version in the Server page of the dashboard. Cloudron releases prior to 10.0.5 do not support upgrading to Ubuntu 26.04 from Ubuntu 24.
  • Ubuntu must be on version 24.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 # use -d if Canonical has not offered 26.04 yet

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​

The upgrade installs sudo-rs. It does not support the syslog and closefrom_override options in /etc/sudoers.d/cloudron. Remove it:

bash
apt remove sudo-rs

The upgrade removes mysql-server-8.0. Install MySQL 8.4:

bash
systemctl stop box
apt install mysql-server
systemctl start box

Preserve MySQL data if asked.

Post upgrade checks​

  1. Verify Ubuntu 26.04 in output:
    bash
    lsb_release -a
  2. Verify active (running) status:
    bash
    systemctl status box
  3. 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 24 to Ubuntu 26.