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.
- Check the OS, Privileges, and Internet Access Requirements
- Download RStudio Package Manager Installer
- Install RStudio Package Manager - Ubuntu 2.2.1, Red Hat/CentOS/SUSE 2.2.2,
- Initial Configuration - 2.3
- Activate RStudio Package Manager License - 4
- Start RStudio Package Manager - 3.1. At this point, RStudio Package Manager will be available at your specified URL.
- 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.
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:
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 18.104.22.168. 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.
22.214.171.124 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.
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
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.
.deb file is available locally, run the following command to
install RStudio Package Manager.
sudo gdebi rstudio-pm_0.6.0-5.deb
This will install RStudio Package Manager into
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
zypper. If you have only a link to the RPM
file, you can use
wget to download the file to the current directory.
sudo yum install --nogpgcheck rstudio-pm-0.6.0-5.x86_64.rpm
sudo zypper --no-gpg-checks install rstudio-pm-0.6.0-5.x86_64.rpm
This will install RStudio Package Manager into
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:
Address = http://r-packages.example.com
The other configuration properties may also be set, see: A for details.
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.