Skip to main content

Upgrading to Ubuntu 22.04 (Jammy Jellyfish)

Overview​

This guide explains how to upgrade an existing Ubuntu 20.04 based Cloudron to Ubuntu 22.04. If still on Ubuntu 18, first upgrade to Ubuntu 20 using this guide.

!!! warning "Cloudron 9 dropped the support for Ubuntu 20"

Checklist​

Before upgrading, please note the following:

  • Cloudron has to be on at least version 7.2. This can be verified by checking the version in the Settings view. Cloudron releases prior to 7.2.0 do not support Ubuntu 22.04.
  • Ubuntu has to be on version 20.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
Upgrade fails with Full text search feature

A bug in Cloudron 7.2 prevents the mail server from starting on Ubuntu 22 when Full text search is enabled. Wait for Cloudron 7.3 before upgrading.

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).
  • Ignore any nginx upgrade failures at the end.

Restart the server after the upgrade completes.

Post Upgrade​

  1. Verify the upgrade: lsb_release -a

  2. Install missing packages: /home/yellowtent/box/scripts/init-ubuntu.sh

  3. Fix package configuration: /home/yellowtent/box/setup/start.sh

  4. Ubuntu 22 uses cgroups v2 by default. Recreate all Docker containers to recognize this change: /home/yellowtent/box/scripts/recreate-containers. This script is part of Cloudron 7.3. For earlier versions, download it here.

Post Upgrade checks​

  1. Verify that the output includes Ubuntu 22.04
    Bash
    lsb_release -a
  2. Verify that the output includes active (running)
    Bash
    systemctl status box
  3. Verify that all the services in the Services view of Cloudron dashboard are running.

!!! info "Cloudron Version 8.X"

If you are running a Cloudron version before version 9, also run the following command:

Bash
systemctl status collectd

The output should include active (running).

!!! success "Upgrade Successful" If the above steps are all confirmed, you have successfully upgraded your Ubuntu 20 to Ubuntu 22