How to Use Topgrade to Easily Upgrade Your Linux System

Topgrade Upgrade Linux Featured

Upgrading Linux has gotten much easier than it used to be. In the old days, you might upgrade certain pieces of software, but mostly you would wait until you bought the next version of your distro of choice. Then you’d install it and marvel at the upgraded software.

Package management systems have made this easy, but they can’t update every part of your system. What about Ruby Gems or packages you installed via a third-party package manager like Linuxbrew? How will you keep your your configuration files synced?

What Is Topgrade?

You can get a clue of just what Topgrade is meant to do by looking at its GitHub page. Its slogan, written at the top of the page, is “upgrade everything.” That’s exactly what it is meant to do.

While we’re focusing on Linux here, Topgrade also works on macOS and Windows. Topgrade is written in Rust, so it should be rather speedy. It’s also licensed under the GNU GPL 3.0, so it’s free as in libre, not just free of charge.

What Does Topgrade Update?

On Linux it will upgrade your system via its package manager, but that’s just the beginning. It will also upgrade Ruby Gems, Atom packages, Linuxbrew and nix packages, and more. It also upgrades apps installed via Snap or Flatpak. This is far from everything, but it should give you an idea.

Topgrade can also upgrade a large portion of your configuration files. It will upgrade your Vim or Neovim configuration if you use NeoBundle, Vundle, Plug, or Dein. If you use a Git repository for your dotfiles, it will also pull any recent changes to them.

Topgrade Upgrade Linux System Upgrade

You can also add custom commands for Topgrade to run while upgrading. This is handy if you use some custom scripts you’d like to keep automatically updated.

Installing Topgrade

If you run Arch, Topgrade is available via the AUR package. If you use another distro, you’ll need to install Cargo, an installer for Rust packages. Fortunately, this is fairly easy. On Ubuntu, you can install it with the following commands:

sudo apt-get update
sudo apt-get install cargo

Once Cargo is installed, you can install Topgrade with the following command:

sudo cargo install topgrade

If this doesn’t work, or you don’t want to install Cargo, precompiled binaries are available via the Topgrade releases page on GitHub.

Using Topgrade

Topgrade Upgrade Linux Summary

Now that Topgrade is installed, keeping your system up to date is easy. To run Topgrade’s basic update steps, just run the command:


If you want to add some custom commands or tweak how Topgrade works, you’ll need to edit its configuration file. On Linux, this is located at “~/.config/topgrade.toml.” For example, if you have a list of Git repositories you’d like to refresh, add the following to the file:

git-repos = [

For more information on tweaking the configuration file, see the Customization section on the Topgrade GitHub page.


Topgrade gives you a ton of power when it comes to keeping your system up to date. That said, it may be overkill if you just want to keep your system up to date and secure. If you don’t install much third-party software, you may not need Topgrade.

If you’re just looking to keep Ubuntu up to date but aren’t sure how, don’t worry. It’s a fairly simple and easy process. Take a look at our guide on how to upgrade Ubuntu via the command line.

Kris Wouk
Kris Wouk

Kris Wouk is a writer, musician, and whatever it's called when someone makes videos for the web.

Subscribe to our newsletter!

Our latest tutorials delivered straight to your inbox