Installing Posit Package Manager

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 might be required to install Package Manager.

NoteMulti-server installation

If you want 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.

Prerequisites

Please review and complete the following before proceeding:

For air-gapped or offline installations, review these additional requirements:

Advanced

Step 1. Download and install

Download and install the server application:

Terminal
curl -1sLf \
  'https://dl.posit.co/public/pro/setup.deb.sh' \
  | sudo -E bash

sudo apt-get install rstudio-pm=2026.04.1
sudo apt-mark hold rstudio-pm
Terminal
curl -1sLf \
  'https://dl.posit.co/public/pro/setup.rpm.sh' \
  | sudo -E bash

sudo dnf install rstudio-pm-2026.04.1
sudo dnf install 'dnf-command(versionlock)'
sudo dnf versionlock add rstudio-pm
Terminal
curl -1sLf \
  'https://dl.posit.co/public/pro/setup.rpm.sh' \
  | sudo -E bash

sudo zypper refresh
sudo zypper install rstudio-pm=2026.04.1
sudo zypper addlock rstudio-pm

The package is held after installation to prevent unintended upgrades during routine system maintenance.

TipMore ways to install

The setup scripts above should find exactly what you need to install. If you would like to look through all of the binaries, you can find them at Posit Package Repository.

Note

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.

Signed Build

If you installed using the Posit Package Repository method recommended above, the GPG key is automatically imported when you run the setup script (setup.deb.sh or setup.rpm.sh). Package signatures are verified automatically during installation. No manual steps are required.

Step 2. Initial Configuration

By default, Package Manager settings are controlled by a configuration file located at /etc/rstudio-pm/rstudio-pm.gcfg.

If Package Manager is served from a subdirectory like /packagemanager/, you must configure the Server.Address setting for some features to work, such as PyPI package serving and the Server API documentation. Server.Address is also required if you are using OpenID Connect authentication.

Server.Address must be the public URL for this server in the format of http(s)://[HOST:PORT]. If Package Manager is deployed behind an HTTP proxy, provide the URL as seen by users through the proxy.

Otherwise, Server.Address is optional and can be left unset.

/etc/rstudio-pm/rstudio-pm.gcfg
[Server]
Address = https://packagemanager.example.com/

; Or if served at a subdirectory like /packagemanager/
;Address = http://example.com:4242/packagemanager/

There are many other options you can configure now or in the future, such as:

TipExample configuration file

An example configuration file that includes all the available configuration settings along with their defaults is installed at /etc/rstudio-pm/rstudio-pm.gcfg.defaults.

Step 3. Activate license

Run the following command to determine the status of your license:

Terminal
/opt/rstudio-pm/bin/license-manager status

If you have a license file, then activate the license by transferring the license file to the server hosting Posit Package Manager, ensure ownership and read permissions for the PPM service user, and activate it with the commands:

Terminal
sudo chown rstudio-pm <license-file>.lic
sudo chmod 0600 <license-file>.lic
sudo cp -a <license-file>.lic /var/lib/rstudio-pm/
sudo systemctl restart rstudio-pm
NoteRunAs User

The default Package Manager RunAs user is rstudio-pm. If you’ve configured a different RunAs user, ensure that user has file ownership.

Posit recommends using license file activation rather than license key activation. License files work well in all environments including ephemeral, container-based, or air-gapped environments. For all activation options, see License activation methods and the Licensing page of this guide.

Step 4. Restart Package Manager

After updating the configuration file and activating the license, you must restart the Package Manager service:

Tip

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:

Terminal
sudo systemctl stop rstudio-pm
sudo systemctl start rstudio-pm

Package Manager supports the HUP signal when:

  • Making licensing changes.
  • Activating a new license.

Step 5. Verify installation

There are two ways to verify a successful Package Manager installation:

  • 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:

  1. Open a web browser.
  2. Navigate to Package Manager by following http(s)://packagemanager.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: /opt/rstudio-pm/bin/rspm list

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:

  1. Run the following to add USER to the rstudio-pm group (replace <USER> with your username):

    Terminal
    sudo usermod -aG rstudio-pm <USER>

  2. Close the terminal or SSH session.

  3. Start a new session and run the groups command. This enumerates the groups that the current user is a member of.

  4. Confirm that rstudio-pm is listed.

  5. Run the command:

    Terminal
    /opt/rstudio-pm/bin/rspm list
Note

You can select a different group to grant access to the Admin CLI. For more information, see the Changing RunAs User page.

Optional downloads

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.

Download and install the standalone CLI

The standalone rspm CLI can be used to remotely manage the server, with actions such as adding packages or uploading binaries remotely. For more information, see the Quick Start page.

Download the standalone Package Manager CLI, ensuring that the CLI version matches the server version:

Terminal
RSPM_SERVER_VERSION=2026.04.1
curl -o rspm -f https://cdn.posit.co/package-manager/linux/amd64/rspm-cli-linux-${RSPM_SERVER_VERSION}
chmod +x rspm
Terminal
RSPM_SERVER_VERSION=2026.04.1
curl -o rspm -f https://cdn.posit.co/package-manager/linux/arm64/rspm-cli-linux-${RSPM_SERVER_VERSION}
chmod +x rspm
Terminal
RSPM_SERVER_VERSION=2026.04.1
curl -o rspm -f https://cdn.posit.co/package-manager/darwin/amd64/rspm-cli-darwin-${RSPM_SERVER_VERSION}
chmod +x rspm

Ensure compatibility by setting the RSPM_SERVER_VERSION environment variable to the server version. The server version can be found by running the following command on a running Package Manager server:

Terminal
$ rspm --version
...
Posit Package Manager Server Version: 2026.04.1; ...

Download and install offline downloader

Advanced

The rspm-offline-downloader utility is required for air-gapped installations of Package Manager to function correctly (see the Air-Gapped Package Manager section):

Terminal
curl -o rspm-offline-downloader -f https://cdn.posit.co/package-manager/linux/amd64/rspm-offline-downloader-linux-2026.04.1
chmod +x rspm-offline-downloader
Terminal
curl -o rspm-offline-downloader -f https://cdn.posit.co/package-manager/linux/arm64/rspm-offline-downloader-linux-2026.04.1
chmod +x rspm-offline-downloader
Terminal
curl -o rspm-offline-downloader -f https://cdn.posit.co/package-manager/darwin/amd64/rspm-offline-downloader-darwin-2026.04.1
chmod +x rspm-offline-downloader

For a list of changes, see the Package Manager: Offline Downloader release notes.

Back to top