4 releases (stable)

10.0.1 Oct 26, 2022
10.0.0 Oct 25, 2022
9.1.1 Oct 18, 2022

#126 in Operating systems

25 downloads per month

Custom license

5.5K SLoC





This is a fork of topgrade by r-darwish to keep it maintained.

Keeping your system up to date usually involves invoking multiple package managers. This results in big, non-portable shell one-liners saved in your shell. To remedy this, topgrade detects which tools you use and runs the appropriate commands to update them.


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 requires Rust 1.51 or above.


You can visit the documentation at topgrade-rs.github.io .


Just run topgrade. See the wiki for the list of things Topgrade supports.


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:

  • Windows - %APPDATA%/topgrade.toml
  • macOS and other Unix systems - ${XDG_CONFIG_HOME:-~/.config}/topgrade.toml


Problems or missing features?

Open a new Issue describing your problem and if possible with a possible solution.

Missing a feature or found an unsupported tool/distro?

Just let us now what you are missing by opening an issue. For tools please open an Issue describing the tool, which platforms it supports and if possible, give us an example of its usage.

Want to contribute to the code?

Just fork the repository and start coding.

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 use ssh to run topgrade on remote hosts before acting locally. To limit the execution only to specific hosts use the --remote-host-limit parameter.


~720K SLoC