The R Installation Manager
Install, remove, configure R versions.
devel, next,
release, oldrel, etc.R-4.1 or R-4.1.2 starts R 4.1.x. Quick links are automatically
added to the user’s path.zsh and bash, on macOS and Linux.lldb, and to allow
core dumps, on macOS.Found another issue? Please report it in our issue tracker.
You can use one of our installers or Homebrew.
Download the latest release from and install it the usual way.
If you use Homebrew (Intel or Arm version), you can install rig with the menu bar app:
brew install r-rig-appThis is a Homebrew cask and needs your password to install.
Or without the menu bar app, command line only:
brew install r-rigYou can use x86_64 rig on Arm macs, and it will be able to install Arm builds of R. But you cannot use Arm rig on Intel macs. If you use both brew versions, only install rig with one of them.
To update rig you can run
brew upgrade r-rig-appThere are several possible ways to install rig on Windows: with our
installer, scoop, choco or winget.
Download the latest release from and install it the usual way.
rig adds itself to the user’s path, but you might need to restart your
terminal after the installation on Windows.
If you use Scoop, you can install rig from the
scoop bucket at
cderv/r-bucket:
scoop bucket add r-bucket https://github.com/cderv/r-bucket.git
scoop install rigTo update run
scoop update rigIf you use Chocolatey (e.g. on GitHub
Actions) you can install rig with
choco install rigand upgrade to the latest version with
choco upgrade rigAn easy way to install rig on Windows 10 and above is to use the
built-in WinGet package manager. The name of the package is posit.rig.
winget install posit.rigNote that updating a WinGet package typically takes some time, so WinGet might not have the latest version of rig.
On Linux you can install rig from a DEB or RPM package, or from a tarball.
We use the R builds from the Posit R-builds project.
Retired Linux distributions
These are not updated any more, no new R builds are added for them, but existing R builds still work.
On any Ubuntu or Debian distro, you can use our package repository to install rig. First you add our key to your config:
`which sudo` curl -L https://rig.r-pkg.org/deb/rig.gpg -o /etc/apt/trusted.gpg.d/rig.gpg
`which sudo` chmod 644 /etc/apt/trusted.gpg.d/rig.gpgThen add the rig repository:
`which sudo` sh -c 'echo "deb http://rig.r-pkg.org/deb rig main" > /etc/apt/sources.list.d/rig.list'If you already added both the key and the repository, then install the
r-rig package (rig is a different package in Debian and Ubuntu):
`which sudo` apt update
`which sudo` apt install r-rigOn most RPM based distros (except for OpenSUSE and SLES) you can install our RPM package directly:
`which sudo` yum install -y https://github.com/r-lib/rig/releases/download/latest/r-rig-latest-1.$(arch).rpmOn OpenSUSE and SLES use zypper instead of yum:
`which sudo` zypper install -y --allow-unsigned-rpm https://github.com/r-lib/rig/releases/download/latest/r-rig-latest-1.$(arch).rpmDownload the latest releast from
and uncompress it to /usr/local
curl -Ls https://github.com/r-lib/rig/releases/download/latest/rig-linux-$(arch)-latest.tar.gz |
`which sudo` tar xz -C /usr/localThe macOS and Linux installers also install completion files for zsh
and bash.
zsh completions work out of the box.
For bash completions install the bash-completion package from
Homebrew or your Linux distribution and make sure it is loaded from your
.bashrc. (You don’t need to install bash from Homebrew, but you can
if you like.)
Use rig add to add a new R installation:
rig add releaseUse rig list to list the currently installed R versions, and
rig default to set the default one.
Run rig to see all commands and examples.
Run rig --help and rig --help to see the documentation.
rig add -- install a new R version [alias: install]
rig available -- list R versions available to install.
rig default -- print or set default R version [alias: switch]
rig library -- manage package libraries [alias: lib] (experimental)
rig list -- list installed R versions [alias: ls]
rig repos -- manage package repositories
rig resolve -- resolve a symbolic R version
rig rm -- remove R versions [aliases: del, remove, delete]
rig rstudio -- start RStudio with specified R version
rig rtools -- manage Rtools installations (on Windows only)
rig run -- run R, an R script or an R project
rig sysreqs -- manage R-related system libraries and tools (experimental)
rig system -- manage current installationsRun rig --help for information about a subcommand.
rig system subcommandsrig system add-pak -- install or update pak for an R version
rig system allow-core-dumps -- allow creating core dumps when R crashes
rig system allow-debugger -- allow debugging R with lldb and gdb
rig system allow-debugger-rstudio -- allow debugging RStudio with lldb and gdb
rig detect-platform -- detect operating system version and distribution
rig system fix-permissions -- restrict system library permissions to admin
rig system forget -- make system forget about R installations
rig system make-links -- create R-* quick links
rig system make-orthogonal -- make installed versions orthogonal
rig system no-openmp -- remove OpenMP (-fopenmp) option for Apple compilers
rig system setup-user-lib -- set up automatic user package libraries [alias: create-lib]rig system subcommandsrig system add-pak -- install or update pak for an R version
rig system clean-registry -- clean stale R related entries in the registry
rig detect-platform -- detect operating system version and distribution
rig system fix-r-alias -- Make the 'R' command start R in PowerShell
rig system make-links -- create R-* quick links
rig system setup-user-lib -- set up automatic user package libraries [alias: create-lib]
rig system update-rtools40 -- update Rtools40 MSYS2 packagesrig system subcommandsrig system add-pak -- install or update pak for an R version
rig system detect-platform -- detect operating system version and distribution
rig system make-links -- create R-* quick links
rig system setup-user-lib -- set up automatic user package libraries [alias: create-lib]View and select the default R version in the macOS menu bar. Start RStudio or a recent RStudio project with the selected R v
No open issues yet, or sync has not completed.