Ubuntu 18.04 is has reached end of life, and we advise our users to take action on their servers on RunCloud.

The best practice is to provision a new server and clone your web application there using our documentation. This will ensure a smooth transition, and avoid any potential issues.

During upgrade, your server will be unavailable for an extended period. However, if you still want to upgrade your server directly, you can follow this guide at your own risk.

RunCloud is not liable for any damages caused by the upgrade process. Please make sure you have a backup or snapshot of your server before proceeding.

Steps to Upgrade Your Server:

  1. Update, upgrade, and restart your server:
apt-get update
apt-get upgrade
reboot -h now
  1. Perform a release upgrade:
sudo do-release-upgrade

Use the default configuration when prompted.

  1. Edit the runcloud.list file, it is present at /etc/apt/sources.list.d/runcloud.list

If the file is already updated, just un-comment this line:

deb [arch=amd64] https://release.runcloud.io/ jammy main

Otherwise, replace this line:

deb [arch=amd64] https://release.runcloud.io/ bionic main


deb [arch=amd64] https://release.runcloud.io/ jammy main
  1. Edit the /etc/adduser.conf file, and find the line containing the DIR_MODE variable. Make sure its value is set to 0755.
  1. Import GPG keys:
Note: This step is only required for servers that are provisioned before July 2022. You can check with your service provider on the instance creation date.

Run these commands to get the latest keys:

curl -o /etc/apt/trusted.gpg.d/runcloud_release_key.asc "https://release.runcloud.io/runcloud.key"
curl -o /etc/apt/trusted.gpg.d/mariadb_release_signing_key.asc "https://mariadb.org/mariadb_release_signing_key.asc"
  1. Upgrade to the latest RunCloud Agent:
apt-get update
apt-get upgrade

By following these steps, you will start the upgrade process from Ubuntu 18 to 22. Please be patient and careful as this may take some time, and may cause some errors or warnings.

If you encounter any problems during or after the upgrade, you can reach out to us in the RunCloud community.