Skip to content

Troubleshooting SSL related issues in RStudio products#

RStudio Professional products (RStudio Server Pro, RStudio Connect, and RStudio Package Manager) can be configured to use SSL Certificates.

Overview#

This guide provides examples of a few common scenarios that you may encounter while configuring or using SSL certificates in RStudio Professional products and how to troubleshoot them.

Configure SSL#

The configuration instructions are covered in a separate topic.

To review the configuration instructions, please select one of the following links for your product:

Scenario 1: SSL Certificates don't work when Publishing to RStudio Connect#

Problem:

While publishing content from RStudio Server Pro to an RStudio Connect instance with SSL configured, the user may encounter an error related to certificate not trusted.

Solution:

In order to resolve this, you will have to register the certificate used by Connect in the RStudio Server Pro server. The instructions depend on the flavor of Linux being used.


Scenario 2: RStudio Server Pro and RStudio Connect are not able to download packages from RStudio Package Manager#

Problem:

install.packages package isn't working correctly.

When the RStudio Package Manager server has an SSL certificate assigned to it, then the Linux OS for both RStudio Server Pro and RStudio Connect needs to trust the certificate. If not, then the install.packages package does not work correctly.

Solution:

This issue is similar to the issue described in Scenario 1. It can be resolved by following the Linux-flavor specific instructions to add SSL certificates to the machine.


Scenario 3: SSL Certificate not working with Local Launcher#

Problem:

Error when launching sessions.

If you have configured local launcher in RStudio Server Pro and are using SSL certificates, you might encounter an error while launching sessions.

The error will read like:

Console output
Error launching jobs:

"please verify your callback address setting for launcher.conf."

Solution:

In order to resolve this issue, you need to update the Local launcher configuration so that the launcher uses the correct callback address of the RStudio Server Pro that has an SSL certificate added to it.


Scenario 4: Troubleshooting SSL Issues with pins package#

Problem:

Error when Shiny Apps are trying to access pins.

A common issue when using pins is when the user can successfully push pins to an RStudio Connect server and call the pins, but Shiny Apps that are trying to access the pin are failing.

The error will read like:

Console output
"Error in value[[3L]](cond) : Peer's Certificate issuer is not recognized."

Solution:

A potential solution for this issue is to add the certificate that is used by the RStudio Connect server to the trusted store on the RStudio Connect server itself, given that it's local request.

If that doesn't work or if it isn't an option, then you can approach this issue from your R code instead. To approach this using your R code, execute the following setting before the pins package is used:

Console
httr::set_config(config(ssl_verifypeer = FALSE, ssl_verifyhost = FALSE))

Didn't find a solution?#

If your scenario is not covered by this guide and you are still having trouble, please: