This section provides the minimum amount of steps required to install RSPM. However, depending on your environment, additional steps may be required to install RSPM. If this is the case, additional information regarding these steps is available in subsequent chapters of this guide.
RStudio is happy to provide support for anyone using our product. However, we do not provide support for:
- Professional services
We don't provide support for these items because our top priority is to focus on building the best products for our users. We understand that you may require additional assistance. If you require such assistance, then please refer to our certified partners.
RStudio's support is limited to our professional products. If your question is related to R, R code, or specific R packages, then visit the RStudio Community.
If your question is related to RSPM, then open a support ticket by following the steps listed on our Support Page. Our Support Agreement also provides important details about the support that RStudio provides.
Download and Install RSPM¶
Run the installation instructions for your Linux distribution:
sudo apt update sudo apt install gdebi-core wget https://s3.amazonaws.com/rstudio-package-manager/ubuntu/amd64/rstudio-pm_1.2.2-4_amd64.deb sudo gdebi rstudio-pm_1.2.2-4_amd64.deb
sudo apt update sudo apt install gdebi-core wget https://s3.amazonaws.com/rstudio-package-manager/ubuntu20/amd64/rstudio-pm_1.2.2-4_amd64.deb sudo gdebi rstudio-pm_1.2.2-4_amd64.deb
wget https://s3.amazonaws.com/rstudio-package-manager/centos/x86_64/rstudio-pm-1.2.2-4.x86_64.rpm sudo yum install rstudio-pm-1.2.2-4.x86_64.rpm
wget https://s3.amazonaws.com/rstudio-package-manager/centos8/x86_64/rstudio-pm-1.2.2-4.x86_64.rpm sudo yum install rstudio-pm-1.2.2-4.x86_64.rpm
sudo zypper refresh wget https://s3.amazonaws.com/rstudio-package-manager/opensuse/x86_64/rstudio-pm-1.2.2-4.x86_64.rpm sudo zypper install rstudio-pm-1.2.2-4.x86_64.rpm
sudo zypper refresh wget https://s3.amazonaws.com/rstudio-package-manager/opensuse15/x86_64/rstudio-pm-1.2.2-4.x86_64.rpm sudo zypper install rstudio-pm-1.2.2-4.x86_64.rpm
These commands will install the product into
See the Appendix - Manual Installation for Minimal Root Use to install into a non-default location or to perform a non-root install.
Signed RSPM Build¶
The RSPM installer is signed with a key belonging to RStudio. If you'd like to know more about the benefits of using signed builds, see the RStudio Signed Builds page.
If you wish to verify this signature, then do one of the following:
- Obtain the public key from our website and save it into a file (e.g.,
- Obtain the key from a GnuPG keyserver using the following commands:
gpg --keyserver keys.gnupg.net --recv-keys 3F32EE77E331692F
gpg --keyserver keys.gnupg.net --recv-keys 3F32EE77E331692F gpg --armor --export 3F32EE77E331692F > rstudio-code-signing.key # Import the key into the set of keys RPM uses to validate package signatures rpm --import rstudio-code-signing.key
After obtaining the GnuPG key, validate the RSPM installer executing the following commands:
dpkg-sig --verify rstudio-pm_1.2.2-4_amd64.deb
rpm -K rstudio-pm-1.2.2-4.x86_64.rpm
By default, the RSPM settings are controlled by a configuration file located
/etc/rstudio-pm/rstudio-pm.gcfg. At a minimum, complete the
Address property within the
Do this by specifying the URL used to access RSPM:
; /etc/rstudio-pm/rstudio-pm.gcfg [Server] Address = http://r-packages.example.com
http://r-packages.example.com with the value appropriate for your
There are many other options that you may want to configure now or at a later point, such as:
- The on-disk location where data will be stored, default:
- The database where essential metadata should be stored, default: built-in SQLite.
- Important security settings settings such as HTTPS certificates and ports; the default is HTTP on port 4242.
- High Availability and Load Balancing options.
An example configuration file that includes all the available configuration settings along with their defaults is installed at
To verify the status of your license:
If you have a license key, then activate the license by replacing
LICENSE_KEY with the value of your license key:
/opt/rstudio-pm/bin/license-manager activate LICENSE_KEY
See the Licensing section for full details and information about offline activation.
Restart RStudio Package Manager¶
After updating the configuration file settings, it is required that you restart the RSPM service.
Most configuration setting changes can also be updated by taking the RSPM service offline and bringing it back online. See the Online and Offline Modes page for more information.
To restart the RSPM service, run the following commands:
sudo systemctl stop rstudio-pm sudo systemctl start rstudio-pm
RSPM supports the
HUP signal when:
- You are making licensing changes.
- Activating a new license.
HUP signal when your configuration changes are limited to properties marked as reloadable. Perform a full restart of RStudio Package Manager when changing other properties.
HUP signal only reloads configuration settings that have explicitly changed.
Commenting out a setting will not affect the configuration when using the
signal. If you have commented out a setting instead of changing the setting
value, restart the RStudio Package Manager service instead of using the
See the Appendix - Reloadable Properties section to learn which settings may be reloaded via HUP.
View the RStudio Package Manager Web User Interface¶
As a user, you can view RSPM in a web browser, which provides you a user-friendly interface for viewing information about packages, package READMEs, metrics, etc.
To view RSPM in a web browser:
- Open a web browser.
- Navigate to RSPM by following
https://r-packages.example.com:<port>(the default port is 4242).
Once you navigate to the link, the RSPM Welcome page displays. For any administrative changes, use the CLI.
The Admin Command-line Interface¶
RSPM is administered through a command-line interface (CLI) which administrators can use to create:
- Create repositories and sources
- Setup sync schedules for CRAN sources
To invoke the Admin CLI, run:
If you aren't able to access the Admin CLI, then verify that your user is a member of the
rstudio-pm group by doing the following:
Run the following to add
<USER>with your username):
sudo usermod -aG rstudio-pm <USER>
Close the terminal or SSH session.
- Start a new session and run the
groupscommand. This enumerates the groups that the current user is a member of.
- Confirm that
- Re-run the command:
You can select a different group to grant access to the Admin CLI. For more information, see the Appendix - Changing RunAs User chapter.