Posit End User License Agreement
This page includes instructions for downloading Posit professional products. Download and/or use of these products is governed under the terms of the Posit End User License Agreement. By downloading, you agree to the terms posted there.
These instructions describe how to install Posit Package Manager on a single Linux server. For alternative installation instructions, see our Install Posit Professional Products overview. Depending on your environment, additional steps may be required to install Package Manager.
If you would like to install Package Manager on multiple Linux servers, use these instructions to install Package Manager on each server and then continue to the Multi-Server Installation procedures.
If you've already installed Package Manager, we recommend reviewing our Quick Start documentation to help administrators configure Package Manager for your organization's specific use cases.
Please review and complete the following before proceeding:
For air-gapped or offline installations, additionals requirements are required:
Step 1. Download and install#
Download and install the server application version 2023.08.0-16 (see the Signed Build section below to verify the signature of the package):
These commands install the product into
/opt/rstudio-pm. See the Manual Installation for Minimal Root Use section to install into a non-default location or to perform a non-root install.
The Package Manager installer is signed with a key belonging to Posit. If you'd like to know more about the benefits of using signed builds, see the Posit Signed Builds page.
For product builds released after 7/25/23 (including new and patched builds), use the "Post 7/25/2023" key. For builds released prior to 7/25/23, use the "Pre 7/25/2023" key.
Obtain the key:
We have two ways to obtain the key:
- 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:
Once you have obtained the key, you need to import it into the set of keys RPM uses to validate package signatures, after which you can validate the package signature using the
Validate the Package Manager installer executing the following commands:
Step 2. Initial Configuration#
By default, Package Manager's settings are controlled by a configuration file located at
/etc/rstudio-pm/rstudio-pm.gcfg. At a minimum, configure the
Address property within the
Do this by specifying the URL used to access Package Manager:
http://r-packages.example.com with the value appropriate for your organization.
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.
Example configuration file
An example configuration file that includes all of the available configuration settings along with their defaults is installed at
Step 3. Activate license#
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:
For full details and information about offline activation, see the Licensing page.
Step 4. Restart Package Manager#
After updating the configuration file and activating the license, it is required that you restart the Package Manager service:
Most configuration setting changes can also be updated by taking the Package Manager service offline and bringing it back online. For more information, see the Online and Offline Modes page.
To restart the Package Manager service, run the following commands:
Package Manager supports the
HUP signal when:
- You are making licensing changes.
- Activating a new license.
Step 5. Verify installation#
There are two ways to verify the successful installation of Posit Package Manager:
- View the Package Manager Web UI.
- The Admin Command-line interface.
View the Package Manager Web UI#
As a user, you can view Package Manager in a web browser, which provides a user-friendly interface for viewing information about packages, package READMEs, metrics, etc. See the User Guide for additional information.
To view Package Manager in a web browser:
- Open a web browser.
- Navigate to Package Manager by following
https://r-packages.example.com:<port>(the default port is 4242).
Once you navigate to the Package Manager URL, the Package Manager Welcome page displays. For any administrative changes, use the CLI.
The Admin Command-line Interface#
Package Manager is administered through a command-line interface (CLI) which administrators can use to:
- 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):
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
Run the command:
You can select a different group to grant access to the Admin CLI. For more information, see the Changing RunAs User page.
There are two additional executables that are optional depending on the intended installation:
- Standalone CLI: Used to remotely manage the server with actions like adding packages or uploading binaries.
- Offline Downloader: Used to download remote assets to initialize or upgrade air-gapped servers.
See the sections below and utilize the Package Manager Admin Guide for usage.
Download and install the standalone CLI#
rspm CLI can be used for several actions such as adding packages or uploading binaries remotely (for more information, see the Quick Start page):
- Download https://cdn.posit.co/package-manager/windows/amd64/rspm-cli-windows-2023.08.0-16.exe
- Rename it to rspm.exe
Ensure compatibility by setting the
RSPM_SERVER_VERSION environment variable to the server version. The server version can be found by running the following commands on a running Package Manager server:
Download and install offline downloader#
rspm-offline-downloader utility is required for air-gapped installations of Package Manager to function correctly (see the Air-Gapped Package Manager section):
- Download https://cdn.posit.co/package-manager/windows/amd64/rspm-offline-downloader-windows-2023.08.0-16.exe
- Rename it to rspm-offline-downloader.exe
For a list of changes, see the Posit Package Manager: Offline Downloader release notes.