do-release-upgrade
Upgrade the operating system to the latest release
TLDR
SYNOPSIS
do-release-upgrade [options]
DESCRIPTION
do-release-upgrade upgrades Ubuntu to a new release version. It handles the complex process of updating sources, upgrading packages, and resolving conflicts. It is the recommended command for upgrading servers and systems without a graphical environment, or when upgrading over a remote connection.By default, upgrades are only offered to the next LTS release (for LTS users) or the next release (for non-LTS users). The -d flag is needed to upgrade to a development release.
PARAMETERS
-h, --help
Show help message and exit.-d, --devel-release
If using the latest supported release, upgrade to the development release.-p, --proposed
Try upgrading using the upgrader from ubuntu-proposed.-c, --check-dist-upgrade-only
Check if a new release is available and exit without upgrading.-m MODE, --mode MODE
Run in a special upgrade mode. Supported modes are "desktop" and "server".-f FRONTEND, --frontend FRONTEND
Run the specified frontend (DistUpgradeViewGtk3, DistUpgradeViewText, DistUpgradeViewNonInteractive).-s, --sandbox
Test upgrade with a sandbox aufs overlay.
CAVEATS
Ubuntu-specific. Backup important data before upgrading. May take significant time. Third-party repositories are disabled during upgrade and may cause issues. Run from a terminal multiplexer (screen or tmux) when upgrading over SSH to avoid disconnection problems.
HISTORY
do-release-upgrade is part of the ubuntu-release-upgrader package, the standard tool for performing Ubuntu release upgrades since at least Ubuntu 8.04 (Hardy Heron). It replaced manual sources.list editing as the recommended upgrade method.
SEE ALSO
apt(8), apt-get(8), update-manager(8), screen(1)
