2 Getting Started with Installation

This chapter helps you install RStudio Package Manager on Ubuntu (Section 2.2.1) or Red Hat Enterprise Linux (Section 2.2.2)/CentOS Linux (Section 2.2.2)/ SUSE Linux Enterprise (Section 2.2.2), learn to manage the server (Section 3.1), and perform some initial configuration (Section 2.3).

We built this checklist to guide you through the initial installation process.

  1. Check the OS, Privileges, and Internet Access Requirements
  2. Download RStudio Package Manager Installer
  3. Install RStudio Package Manager - Ubuntu 2.2.1, Red Hat/CentOS/SUSE 2.2.2,
  4. Initial Configuration - 2.3
  5. Activate RStudio Package Manager License - 4
  6. Start RStudio Package Manager - 3.1. At this point, RStudio Package Manager will be available at your specified URL.
  7. Add Repositories and Packages - 6. After this step, users will be able to install packages and repositories will be available in the web client.

Once RStudio Package Manager is installed, licensed, and started, visit the quick start configuration guides to quickly configure RStudio Package Manager for common scenarios.

2.1 Requirements

Please review the necessary system requirements, account privileges, and internet access requirements prior to installing RStudio Package Manager.

2.1.1 System Requirements

  • Red Hat Enterprise Linux/CentOS Linux 6.0+
  • Red Hat Enterprise Linux/CentOS Linux 7.0+
  • SUSE Enterprise Linux 12 SP3+
  • Ubuntu 14.04
  • Ubuntu 16.04
  • Ubuntu 18.04

RStudio Package Manager should run on a server with a minimum of 2GB of RAM. Package sources can be lazily cached from CRAN or eagerly downloaded. RStudio Package Manager recommends 50-200GB of disk storage.

2.1.2 Internet Access Requirements

RStudio Package Manager acts as a “bridge” between offline servers running R and upstream package sources like CRAN. RStudio Package Manager should be installed on a server in the network with outbound access to:

https://rspm-sync.rstudio.com

See Repository Syncing for more details on what information is downloaded from the RStudio CRAN service.

RStudio Package Manager can be configured to use a HTTP proxy to access the internet, see Outbound Proxy for more details.

Additional steps are necessary if your internal servers can not access an online server through your internal network. See the appendix on running RStudio Package Manager in an air-gapped environment.

2.1.3 Root Requirements

RStudio Package Manager does not run as root, see 2.1.3.1. By default, root privileges are required to:

  • Install RStudio Package Manager
  • Start and Stop RStudio Package Manager via the service daemons
  • Activate the RStudio Package Manager license

RStudio Package Manager can be installed and licensed without requiring root privileges. Instructions are available in the appendix.

2.1.3.1 RunAs User

RStudio Package Manager runs under an unprivileged account.

The installer creates a user account and group named rstudio-pm and runs the RStudio Package Manager service under this account. If you wish to change the account under which the service runs, please see C.

2.2 Installation

Please follow the installation instructions specific to your operating system.

2.2.1 Install RStudio Package Manager - Ubuntu

You will use gdebi to install RStudio Package Manager and its dependencies. It is installed via the gdebi-core package.

sudo apt-get install gdebi-core

You should have been provided with a .deb installer for RStudio Package Manager. If you only have a link to this file, you can use wget to download the file to the current directory.

wget https://download-url/rstudio-pm_0.7.0-1.deb

Once the .deb file is available locally, run the following command to install RStudio Package Manager.

sudo gdebi rstudio-pm_0.7.0-1.deb

This will install RStudio Package Manager into /opt/rstudio-pm

2.2.2 Install RStudio Package Manager - RedHat/SUSE

You should have been provided with an RPM file which contains RStudio Package Manager. You can install this rpm file using yum/zypper. If you have only a link to the RPM file, you can use wget to download the file to the current directory.

For RedHat:

sudo yum install --nogpgcheck rstudio-pm-0.7.0-1.x86_64.rpm

For SUSE:

sudo zypper --no-gpg-checks install rstudio-pm-0.7.0-1.x86_64.rpm

This will install RStudio Package Manager into /opt/rstudio-pm/.

2.3 Initial Configuration

Before RStudio Package Manager can run, you will need to update the configuration file located at /etc/rstudio-pm/rstudio-pm.gcfg. Complete the Address property within the Server section by specifying the URL used to access RStudio Package Manager by clients. For example:

; /etc/rstudio-pm/rstudio-pm.gcfg 

[Server]
Address = http://r-packages.example.com

The other configuration properties may also be set, see: A for details.

After updating the configuration file, follow the steps in 4 to activate the RStudio Package Manager license and then restart the server 3.1.

At this point, the web client is available at the server address you selected. The default address is http://<server_ip>:4242. Though the client is available, no repositories are available yet. The next step is to configure sources and repositories using the admin CLI 6. We recommend visiting the quickstart configuration guides.