Before installing RSPM, review the necessary system requirements, account privileges, and internet access requirements.
RSPM is supported on the following Linux distributions:
- Red Hat Enterprise Linux/CentOS Linux 7+
- Red Hat Enterprise Linux/CentOS Linux 8+
- SUSE Linux Enterprise Server 12 SP5
- SUSE Linux Enterprise Server 15 SP2
- openSUSE Leap 15.2
- Ubuntu 18.04 (Bionic Beaver)
- Ubuntu 20.04 (Focal Fossa)
Within each version of a Linux distribution, we support the latest patch release or "service pack." The RStudio Platform Support page explains the support period for each Linux distribution.
We currently only offer installers for the x86-64 architecture.
RSPM is supported against the latest versions of the following browsers:
- Microsoft Edge
It is recommended that you run RSPM on a server with a minimum of:
- 2 GB of RAM
- 100+ GB of disk storage
RSPM may require more than 2 GB of RAM and 100+ GB of disk storage, depending upon configuration and usage. If you enable Bioconductor Packages, Linux R package Binaries, and/or Python PyPI Mirroring, consider adding additional disk storage.
Internet Access Requirements#
RSPM periodically receives package updates from RStudio’s online servers. Installations need to be on servers with outbound access to:
This ensures that the CRAN, Bioconductor, and/or PyPI sources receive the latest package updates. Note that the service can also be configured to use an outbound HTTP proxy to access the internet.
For more information on what is being downloaded from:
- the RStudio CRAN service, see the CRAN Source section.
- the RStudio PyPI service, see the PyPI Source section.
If your internal servers do not have access to the internet, then follow the installation steps for an air-gapped environment.
Air-Gapped System Requirements#
The amount of storage that is required to run RSPM on an offline environment varies based on several things.
- If you're running RSPM in an offline environment and your unique configuration, then the amount of storage required increases. 100+ GB of storage should be sufficient for the most basic setups.
- If R package binaries are enabled, then the amount of storage depends on the number of minor R versions, operating
systems, and Linux releases (if applicable) supported. For more information about R package binaries,
see the Serving Package Binaries section.
- For each minor R version, operating system, and Linux release (if applicable) RSPM requires at least an additional 100 GB of storage space.
As an example, to support R package binaries for R 3.6 and 4.0 on both Linux CentOS 7 and CentOS 8, we recommend having at least 400 GB of storage space available.
By default, RSPM does not run as root. For more information, see the RunAs User section.
By default, root privileges are required to:
- Install RSPM
- Start and Stop RSPM via the service daemons
- Activate RSPM license
RSPM can be installed and licensed without requiring root privileges. Instructions are available in the Appendix - Manual Installation for Minimal Root Use.
The RSPM service does not run as root by default. Instead, RSPM starts and runs under an unprivileged account.
The installer creates a user account and group named
rstudio-pm and it runs
RSPM service under this account.
If you wish to change the account under which the service runs, then refer to the Appendix - Changing RunAs User.
There are two exceptions to the installer creating and running under the default user account:
- If the user already exists, then it isn't created.
- If the initial system was configured for RSPM to run as a different user account, then the installer attempts to detect the user account. If it exists, then RSPM attempts to use the configured user account instead of the default
The Git sources functionality allows RSPM to automatically expose R packages that are tracked in Git.
If you plan on using Git sources, then RSPM requires:
- A valid installation of R version 3.0.0 or greater
- A configured R installation
Therefore, to utilize Git sources, you must:
- Install R
- Update and configure the R installation
Additionally, Git sources require a configured R installation.
For more information about Git sources, see the Git Sources section.
For more information about building R packages, see the Building R Packages section.