2020-07-09 21:29:28 +03:00
|
|
|
|
|
|
|
|
|
2018-06-28 12:04:56 +03:00
|
|
|
[](https://travis-ci.org/r-darwish/topgrade)
|
|
|
|
|
[](https://ci.appveyor.com/project/r-darwish/topgrade)
|
2018-08-29 14:40:59 +03:00
|
|
|
|
2018-07-05 13:01:43 +03:00
|
|
|
[](https://crates.io/crates/topgrade)
|
2018-08-22 16:59:28 +03:00
|
|
|
[](https://aur.archlinux.org/packages/topgrade/)
|
2018-08-29 14:40:59 +03:00
|
|
|
|
2018-05-31 16:27:23 +03:00
|
|
|
|
2020-07-09 21:29:28 +03:00
|
|
|
|
2018-05-31 16:27:23 +03:00
|
|
|
|
|
|
|
|
Keeping your system up to date mostly involves invoking more than a single package manager. This
|
2018-06-10 11:23:44 +03:00
|
|
|
usually results in big shell one-liners saved in your shell history. Topgrade tries to solve this
|
2018-06-11 16:51:14 +03:00
|
|
|
problem by detecting which tools you use and run their appropriate package managers.
|
2018-05-31 16:27:23 +03:00
|
|
|
|
|
|
|
|
## Installation
|
2018-06-10 14:42:10 +03:00
|
|
|
Arch Linux users can use the [AUR](https://aur.archlinux.org/packages/topgrade/) package.
|
|
|
|
|
|
2020-06-26 09:15:14 +03:00
|
|
|
On NixOS, use the `topgrade` package in `nixpkgs`.
|
2019-11-11 22:16:40 +02:00
|
|
|
|
2020-07-13 13:51:42 +02:00
|
|
|
macOS users can install topgrade via [Homebrew](https://brew.sh/) or [MacPorts](https://www.macports.org/install.php).
|
2018-08-29 11:43:44 +03:00
|
|
|
|
2021-12-06 14:14:07 +02:00
|
|
|
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.
|
2018-09-05 11:23:04 +03:00
|
|
|
|
2021-12-06 14:14:07 +02:00
|
|
|
Topgrade requires Rust 1.51 or above.
|
2018-05-31 16:27:23 +03:00
|
|
|
|
|
|
|
|
## Usage
|
2020-02-27 21:22:57 +02:00
|
|
|
Just run `topgrade`. See [the wiki](https://github.com/r-darwish/topgrade/wiki/Step-list) for the list of things Topgrade supports
|
2018-06-11 13:57:38 +03:00
|
|
|
|
|
|
|
|
## Customization
|
2019-08-22 22:08:28 +03:00
|
|
|
See `config.example.toml` for an example configuration file.
|
2019-01-21 20:17:44 +02:00
|
|
|
|
|
|
|
|
### Configuration path
|
|
|
|
|
|
|
|
|
|
The configuration should be placed in the following paths depending by the operating system:
|
|
|
|
|
|
2020-03-08 18:22:48 +01:00
|
|
|
* **macOS** - `~/.config/topgrade.toml`
|
2019-01-21 20:17:44 +02:00
|
|
|
* **Windows** - `%APPDATA%/topgrade.toml`
|
|
|
|
|
* **Other Unix systems** - `~/.config/topgrade.toml`
|
2019-06-05 14:15:45 +03:00
|
|
|
|
|
|
|
|
## 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
|
2020-08-03 19:07:53 +02:00
|
|
|
remote hosts. To limit the execution only to specific hosts use the `--remote-host-limit` parameter.
|
