Repository files navigation

This repository is no longer maintained. An effort was made by the community to keep maintaining the project athttps://github.com/topgrade-rs/topgrade. I am not involved in this effort nor do I know the people behind it, so I encourage you to inspect their work before using the fork.

I'm not the owner of the packages that ship Topgrade for various package managers, so their maintainers will need to decide what to do. I'm only the owner of the package in creates.io, which will no longer be updated.

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.

• Arch Linux:AUR package.
• NixOS:topgrade package innixpkgs.
• macOS:Homebrew orMacPorts.

Other systems users can either usecargo 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.

Just runtopgrade.Seethe wiki for the list of things Topgrade supports.

Seeconfig.example.toml for an example configuration file.

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

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

You can specify a key calledremote_topgrades in the configuration file.This key should contain a list of hostnames that have topgrade installed on them.Topgrade will usessh to runtopgrade on remote hosts before acting locally.To limit the execution only to specific hosts use the--remote-host-limit parameter.