This guide walks you through upgrading Ubuntu 24.04 LTS to 26.04 LTS from the terminal using Ubuntu's official upgrade tool. Plan on 1–2 hours, depending on your internet speed and how many packages you have.
You don't need to be a Linux expert. You'll type a few commands, answer some on-screen prompts, and reboot. Lines that start with $ are commands: type everything after the $ and press Enter.
Check every item below before you begin. Most failed upgrades come from skipping one of them.
Check that the upgrade is being offered to you:
$ do-release-upgrade -c
If you see New release '26.04.x LTS' available, you're ready. If it says No new release found, see Troubleshooting at the end.
Make two backups: a system snapshot so you can roll back, and a copy of your personal files in case something goes badly wrong.
System snapshot with Timeshift. Install it if you don't have it:
$ sudo apt install timeshift
Open Timeshift from the app menu. Choose RSYNC as the snapshot type, pick a drive with enough space, and click Create. Or use the terminal:
$ sudo timeshift --create --comments "Before 26.04 upgrade"
By default Timeshift skips your home folder, so this snapshot covers the system only.
Personal files. Copy your home folder (Documents, Pictures, projects, and so on) to an external drive or cloud storage. Swap in your own drive name:
$ rsync -a --info=progress2 ~/ /media/$USER/BackupDrive/home-backup/
Save a list of your apps. This makes reinstalling easier if you ever need to:
$ dpkg --get-selections > ~/package-list.txt
$ snap list > ~/snap-list.txt
The upgrade tool won't run if updates are still pending. Install every update for 24.04 first:
$ sudo apt update
$ sudo apt full-upgrade
$ sudo snap refresh
Press Y when asked. Then check for broken or held packages:
$ sudo dpkg --audit
$ apt-mark showhold
Both should print nothing. If apt-mark showhold lists packages, release them with sudo apt-mark unhold <package-name>.
If /var/run/reboot-required exists, reboot now and continue after you log back in:
$ [ -f /var/run/reboot-required ] && sudo reboot
Apps you added from outside Ubuntu, like Google Chrome, VS Code, Slack, or PPAs, have their own software sources. The upgrade tool turns these off automatically to avoid conflicts. Note what you have so you can turn them back on later:
$ ls /etc/apt/sources.list.d/
You'll see files such as google-chrome.sources, vscode.sources, or some-ppa-ubuntu-noble.sources. Ignore ubuntu.sources, which is Ubuntu's own.
Take a photo or write down the list. If an app is critical to your work, check its website to confirm it supports 26.04.
Start the official upgrade tool:
$ sudo do-release-upgrade
It runs in stages and stops to ask you questions along the way. Here's what each prompt means and how to answer:
Watch out for [yN] prompts. The capital letter is the default answer, the one you get by pressing Enter alone. At a [yN] prompt, Enter means no, which can cancel the upgrade. Type y and then press Enter to continue.
| Prompt you'll see | What it means | What to do |
|---|---|---|
| "Continue running under SSH?" | You're connected remotely | Only on a remote machine: press y. It starts a backup SSH server on port 1022 |
| "Third party sources disabled" | Your extra app sources were turned off (Step 3) | Press Enter |
| "Do you want to start the upgrade?" | Shows how many packages will change and the download size | Read it, then press y |
| "Restart services during package upgrades without asking?" | Lets background services restart on their own | Press y (or choose Yes) |
| "Configuration file ... modified" | You or an app changed a settings file Ubuntu wants to update | If unsure, press N to keep your current version |
| "Remove obsolete packages?" | Old packages 26.04 no longer needs | Press y |
| "Restart required" | Upgrade finished | Press y to reboot |
The download and install can take 30–90 minutes. The screen may look stuck at times. That's normal, so don't close the terminal or turn off the computer.
If you'd rather use a graphical tool on Ubuntu Desktop, run update-manager -c instead and click Upgrade. It walks through the same steps.
After the reboot, log in and confirm the new version:
$ lsb_release -a
$ uname -r
Don't rely on the reboot alone. A reboot after Step 2 can install a newer kernel, which can look like the upgrade worked. Only the Description line from lsb_release -a proves it. If it still says 24.04, the upgrade didn't run or was cancelled, so go back to Step 4. If it quit early, run it again and read the last message on screen.
Once it says Ubuntu 26.04.x LTS, check that nothing was left half-installed:
$ sudo apt update
$ sudo apt full-upgrade
$ sudo dpkg --configure -a
Test the things you use daily: Wi-Fi, sound, display, printer, and your main apps.
Using Ubuntu Pro? Check it too:
$ pro status
If services show n/a, refresh your subscription for the new release, then check again:
$ sudo pro refresh
$ pro status
Open Software & Updates, go to the Other Software tab, and tick the sources you want back on. Or list the disabled ones in the terminal:
$ grep -l "Enabled: no" /etc/apt/sources.list.d/*.sources
For each one, open the file with sudo nano <file> and change Enabled: no to Enabled: yes. For PPAs, replace noble with the 26.04 codename on the Suites: line, but only if the PPA has published packages for 26.04.
Sources that use .list files. Some sources can't be converted automatically, so you'll see a file ending in .list.disabled and no matching .sources file. Don't edit the old file. Follow the vendor's Linux install instructions for 26.04 to add the source again. If the source line names a release, use the 26.04 codename instead of noble:
$ ls /etc/apt/sources.list.d/*.disabled
Leftover mirrors. Tools like nala can add extra download mirrors, and the upgrade may keep them switched on with the new release name. See which servers apt uses now:
$ apt-cache policy | grep -E 'https?://' | awk '{print $2}' | sort -u
You should see Ubuntu's own servers and the third-party sources you turned on. If you see mirrors you don't need, open their file with sudo nano <file> and add Enabled: no as the first line of each block.
When you're done, refresh your package lists:
$ sudo apt update
$ sudo apt full-upgrade
Remove leftover packages and old kernels:
$ sudo apt autoremove --purge
$ sudo apt clean
Once everything has worked for a week or so, you can delete the pre-upgrade Timeshift snapshot to free up space.
Most upgrades finish cleanly, but a few apps may need a small fix. 26.04 changes the default Python version and tightens some desktop permissions, which causes most of these.
| What you notice | Why it happens | Fix |
|---|---|---|
A Python command fails with ModuleNotFoundError |
The default python3 changed, so packages installed for the old version aren't found |
Reinstall the package for the current version. Use a virtual environment or pipx for your own tools |
| A cron job or script behaves differently | Anything that calls python3 now uses the new version |
Run crontab -l to list your jobs, then test any script that needs extra packages |
| Screenshot app says "Unable to capture screen" | Apps now need permission, and the request is blocked if the app started in the background from a shortcut | Run the app once from a terminal and click Allow |
| Screenshot overlay covers only one monitor | On Wayland, an app window normally stays on one monitor | For Qt apps such as Flameshot, try QT_QPA_PLATFORM=xcb flameshot gui. Check that the overlay lines up with your screens |
| An app has no title bar or close button | On Wayland, GNOME doesn't draw title bars for some apps | For SDL apps such as scrcpy, try SDL_VIDEO_DRIVER=x11 SDL_VIDEODRIVER=x11 scrcpy |
| Copying from an app inside tmux doesn't work | tmux ignores clipboard requests from apps running inside it by default | Add set -g set-clipboard on to ~/.tmux.conf, then reload tmux |
| You have two PostgreSQL versions | The upgrade can move your data to the new version and leave the old one stopped | Run pg_lsclusters. Check your data on the new version before you remove the old one |
| The same app appears twice | The upgrade may add a snap version beside a version you installed another way | Check which one you use with which -a <app>, then remove the other, for example sudo snap remove <app> |
| Problem | Fix |
|---|---|
No new release found |
Make sure the Prompt=lts line is in /etc/update-manager/release-upgrades. LTS-to-LTS upgrades usually open with the first point release (26.04.1). Run sudo apt full-upgrade and try again |
| "Please install all available updates" | Repeat Step 2, then reboot |
| Upgrade stopped partway with errors | Run sudo dpkg --configure -a then sudo apt -f install, then sudo apt full-upgrade |
| Not enough free space | Run sudo apt clean and sudo apt autoremove --purge, and empty the Trash |
| Black screen or no desktop after reboot | Press Ctrl+Alt+F3 for a text login, then run the fix commands above. NVIDIA users: sudo ubuntu-drivers install |
| A third-party app is missing or broken | Re-enable its source (Step 6) or reinstall it from the vendor's site |
The upgrader writes its logs to /var/log/dist-upgrade/. Include them if you ask for help on a forum.
Rolling back. If the system is unusable, restore your Timeshift snapshot. If you can still log in, open Timeshift, select the "Before 26.04 upgrade" snapshot, and click Restore. If you can't boot, start the computer from an Ubuntu live USB, install Timeshift there (sudo apt install timeshift), and restore from it. Your personal files backup from Step 1 is the last resort.