Skip to content

How to install

Riff edited this page Aug 10, 2021 · 4 revisions

How to install Rnp

We currently support multiple ways for installing Rnp.

1. Download the binary package from Github releases

GitHub release (latest SemVer)

The latest release of Rnp can be found here: https://github.com/r12f/rnp/releases.

Rnp has almost no external dll/lib dependencies other than C runtime, so we can simply download the binary package and unpack it to use.

2. Install via package managements

If you prefer to install via package managements, we current support the following package managements:

2.1. Via chocolatey on windows

2.1.1. From official feed

Chocolatey Version

Chocolatey is one of the most popular package management for installing softwares on windows, if not the most. But it doesn’t come with windows and needs to be installed. If you like to use it to manage your softwares, please follow their installation instructions to install it first.

Once it is done, we can run the following command to install Rnp:

choco install rnp-cli

2.1.2. From project feed

rnp-cli package in rnp-choco feed in Azure Artifacts

Releasing to chocolatey might get delayed due to moderation (Not complain here, they are doing really good job!). If you trust us and like to always get the latest released build, you could add our release feed to your chocolatey source to download the new version.

choco source add -n=rnp-choco -s="https://riff.pkgs.visualstudio.com/rnp/_packaging/rnp-choco/nuget/v2"

Then we can use the exact same command to install it:

choco install rnp-cli

2.2. Via winget on windows

winget

Winget is another package management which is created and managed by Microsoft. Although it sounds official, but it also needs to be installed. Winget can be installed via windows store or downloading their msix package from their github releases. For detailed instructions, please follow their doc here: Installing the client.

There is an undocumented way to install winget, if you prefer to use script (powershell):

iwr https://github.com/microsoft/winget-cli/releases/download/v1.0.11692/Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle -OutFile Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle
Add-AppxPackage .\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle

Once it is done, we can run the following command to install Rnp:

winget install rnp

2.3. Via apt on linux

apt/deb

Before using apt to install Rnp, we need to add our deb source list first.

echo "deb [trusted=yes] https://repo.r12f.com/apt/ /" > ~/r12f.list
sudo mv ~/r12f.list /etc/apt/sources.list.d/r12f.list

Then we can start update the apt package cache and install the latest version:

sudo apt update
sudo apt install rnp

If you prefer apt-get, it also works:

sudo apt-get update
sudo apt-get install rnp

3. Install via crate.io

Crates.io

If you have rust installed on your machine, you can also install directly by getting the crate and compile by yourself.

cargo install rnp