Skip to content

Manual Installation for Minimal Root Use#

Discussion#

The RStudio Package Manager installer requires root privileges and installs the RStudio Package Manager to /opt/rstudio-pm. Additionally, it configures services for systemd, adds log files to /var/log, adds a configuration file under /etc/rstudio-pm, creates an rstudio-pm user account and group, and installs a logrotate configuration.

It is possible to extract the RStudio Package Manager files manually and configure the service to use configuration and data files at a custom location. Most of these steps can be performed without root privileges.

Warning

Unfortunately, given the ad-hoc nature of these install instructions, this path is not recommended, and RStudio can only offer minimal support for customers who run into issues. Do not use the instructions below to perform upgrades, as these need to be performed manually and crafted specifically for the environment.

Extracting Files#

First, download the latest version of RStudio Package Manager from the link provided by RStudio. Then, extract the files from the installer by following the instructions for your operating system, below.

Ubuntu binutils

If you are using Ubuntu, then you may need to install binutils with sudo apt install binutils to use the ar utility.

mkdir rspm
ar x rstudio-pm_2022.04.0-7_amd64.deb
tar -xzvf data.tar.gz -C rspm/
cd rspm
mkdir rspm
cd rspm
rpm2cpio ../rstudio-pm-2022.04.0-7.x86_64.rpm | cpio -div

Create Directories#

Create the directories you need to run RStudio Package Manager.

Terminal

mkdir log
touch log/rstudio-pm.log
touch log/rstudio-pm.access.log
mkdir run
mkdir data
mkdir temp

Licensing#

The license manager used by RStudio Package Manager supports userspace license activation. If you wish to activate a system-wide license, root privileges are required. See the Licensing section for more details on system-wide licensing.

Terminal

# Initialize a trial in userspace
./opt/rstudio-pm/bin/license-manager initialize --userspace

# Activate a userspace license key, if you have a license key
./opt/rstudio-pm/bin/license-manager activate --userspace <key>

Edit config file#

Next, edit the RStudio Package Manager configuration file to point to the directories and access log you created. Add the following lines to the [Server] configuration section.

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

[Server]
DataDir = <path-to-unbundled-rspm-dir>/data
SockFileDir = <path-to-unbundled-rspm-dir>/run
AccessLog = <path-to-unbundled-rspm-dir>/log/rstudio-pm.access.log
TempDir = <path-to-unbundled-rspm-dir>/temp

Start the RStudio Package Manager Service#

When RStudio Package Manager is installed without root, the system daemons are not used to automatically start RStudio Package Manager. Instead, the user is required to start RStudio Package Manager manually and ensure the process continues to run. The command to start RStudio Package Manager is:

Terminal

./opt/rstudio-pm/bin/rstudio-pm --config \
./etc/rstudio-pm/rstudio-pm.gcfg >> ./log/rstudio-pm.log 2>&1

As an example, nohup can be used to launch this command without blocking or depending on the terminal using:

Terminal

nohup ./opt/rstudio-pm/bin/rstudio-pm --config \
./etc/rstudio-pm/rstudio-pm.gcfg >> ./log/rstudio-pm.log 2>&1 &

Use the CLI to Manage RStudio Package Manager#

Terminal

./opt/rstudio-pm/bin/rspm --config ./etc/rstudio-pm/rstudio-pm.gcfg help

In this mode, every CLI command will require the config flag that points at the configuration file.