37 releases (18 stable)

✓ Uses Rust 2018 edition

3.1.0 Oct 6, 2019
2.8.0 Aug 15, 2019
2.3.1 Jun 18, 2019
1.13.0 May 19, 2019
0.10.0 Jul 10, 2018

#6 in Operating systems

Download history 287/week @ 2019-06-23 257/week @ 2019-06-30 111/week @ 2019-07-07 21/week @ 2019-07-14 111/week @ 2019-07-21 90/week @ 2019-07-28 226/week @ 2019-08-04 349/week @ 2019-08-11 152/week @ 2019-08-18 143/week @ 2019-08-25 242/week @ 2019-09-01 260/week @ 2019-09-08 533/week @ 2019-09-15 316/week @ 2019-09-22 195/week @ 2019-09-29

911 downloads per month

Custom license



Travis AppVeyor GitHub release Crates.io AUR homebrew

Alt Text

Keeping your system up to date mostly involves invoking more than a single package manager. This usually results in big shell one-liners saved in your shell history. Topgrade tries to solve this problem by detecting which tools you use and run their appropriate package managers.

Supported Platforms

Topgrade should probably work on whichever platform it can be build. The real question is whether Topgrade knows that platform and can utilize its unique features, such as the operating system's package manager. Topgrade is tested on and knows the following platforms:

  • Linux
    • Arch based
    • Red Hat based
    • Debian based
    • Gentoo
    • openSUSE
    • Void
  • DragonFly BSD
  • FreeBSD
  • macOS
  • Windows


Arch Linux users can use the AUR package.

macOS users can install topgrade via Homebrew.

Other systems users can either use cargo install or use the compiled binaries from the release page. The compiled binaries contain a self-upgrading feature.

Topgrade isn't guaranteed to work on Rust versions older than the latest stable release. If you intend to install Topgrade using Cargo then you should either install Rust using rustup or use a distribution which ships the latest version of Rust, such as Arch Linux.


Just run topgrade. It will run the following steps:

  • Try to self-upgrade if compiled with this feature. Topgrade will respawn itself if it was upgraded.
  • Linux: Run the system package manager:
    • Arch based: Run yay or fall back to pacman
    • Redhat based: Run yum upgrade (or dnf if present)
    • Debian based: Run apt update && apt dist-upgrade
    • Gentoo: Run layman -s ALL && emerge --sync -q && eix-update && emerge -uDNa world
    • openSUSE: Run zypper refresh && zypper dist-upgrade
    • Void: Run xbps-install -Su
  • Linux: Run etc-update:
  • DragonFly BSD: Upgrade and audit packages
  • FreeBSD: Upgrade and audit packages
  • Unix: Run brew update && brew upgrade. This should handle both Homebrew and Linuxbrew
  • Unix: Run nix upgrade-nix && nix --upgrade.
  • Unix: Run Pearl pearl update.
  • Windows: Run Topgrade inside WSL.
  • Windows: Upgrade Powershell modules
  • Windows: Upgrade all Chocolatey packages
  • Windows: Upgrade all Scoop packages
  • Check if the following paths are tracked by Git. If so, pull them:
    • ~/.emacs.d (Should work whether you use Spacemacs or a custom configuration)
    • ~/.zshrc
    • ~/.tmux
    • ~/.config/fish
    • ~/.config/nvim
    • ~/.vim
    • ~/.config/openbox
    • ~/.config/bspwm
    • ~/.config/i3
    • Powershell Profile
    • Custom defined paths
  • Unix: Run zr update
  • Unix: Run zplug update
  • Unix: Run oh-my-zsh update
  • Unix: Run antigen update
  • Unix: Run fisher
  • Unix: Upgrade tmux plugins with TPM. Note: Do not use the -b flag in your configuration as suggested by the TPM readme.
  • Update Rustup by running rustup update. This will also attempt to run rustup self update when Rustup is installed inside the home directory.
  • Run Cargo install-update
  • Upgrade Emacs packages (You'll get a better output if you have Paradox installed)
  • Upgrade OCaml packages
  • Upgrade vcpkg globally installed packages
  • Upgrade myrepos managed sourcecode repositories
  • Upgrade Python packages installed using pipx
  • Upgrade R globally installed packages
  • Upgrade Vim/Neovim packages. Works with the following plugin frameworks:
  • Node
    • Run yarn global update if yarn is installed.
    • Run npm update -g if NPM is installed and npm root -g is a path inside your home directory.
  • Run composer global update if Composer's home directory is inside the home directory of the user. Run valet install after.
  • Upgrade Atom packages
  • Run gem upgrade --user-install if ~/.gem exists
  • Linux: Update Flatpak packages
  • Linux: Update snap packages
  • Linux: Run fwupdmgr to show firmware upgrade. (View only. No upgrades will actually be performed)
  • Linux: Run rpi-update to update Raspberry Pi Firmware
  • Linux: Run pihole updater
  • Run custom defined commands
  • Final stage
    • Linux: Run needrestart
    • Windows: Run Windows Update (You'll have to install PSWindowsUpdate)
    • macOS: Upgrade App Store applications
    • FreeBSD: Run freebsd-upgrade


See config.example.toml for an example configuration file.

Configuration path

The configuration should be placed in the following paths depending by the operating system:

  • macOS - ~/Library/Preferences/topgrade.toml
  • Windows - %APPDATA%/topgrade.toml
  • Other Unix systems - ~/.config/topgrade.toml

Remote execution

You can specify a key called remote_topgrades in the configuration file. This key should contain a list of hostnames that have topgrade installed on them. Topgrade will execute Topgrades on these remote hosts.


~177K SLoC