3 Licensing & Activation

When RStudio Connect is first installed on a system it operates in an evaluation mode for a period of time and then subsequently requires activation for continued use.

To determine the current license status of your system, you can use the following command:

$ sudo /opt/rstudio-connect/bin/license-manager status

After purchasing a license to RStudio Connect, you will receive a product key that is used to activate the license on a given system. Each product key given limits usage of RStudio Connect in the following ways…

  • Number of user accounts that have signed into RStudio Connect. Once this limit is reached, additional users will not be permitted to sign into RStudio Connect. This limit is enforced the first time each user logs in. Locked users are not counted against this quota.
  • Number of users that can access Shiny applications at one moment in time. If this number is exceeded, new anonymous users will be unable to view the Shiny application requested. This limitation does not affect logged in users.

How many are allowed of each metric depends on the license purchased from RStudio.

You can activate your license key with the command:

$ sudo /opt/rstudio-connect/bin/license-manager activate <product-key>

After activation, we recommend restarting the RStudio Connect server. A change in license status will eventually be detected by the product; a forced restart ensures that change is seen immediately.

$ sudo stop rstudio-connect
$ sudo start rstudio-connect

Your platform may need alternate commands to restart RStudio Connect. Please see Section 5.1 for instructions specific to your operating system version.

If you want to move your license of RStudio Connect to another system, you should first deactivate it on the old system.

$ sudo /opt/rstudio-connect/bin/license-manager deactivate

3.1 Proxy Servers

If your server is behind an internet proxy, you may need to add an additional command line flag indicating the address and credentials required to communicate through the proxy. This may not be necessary if either the http_proxy or all_proxy environment variable is defined (these are read and used by the license manager when available).

If you do need to specify a proxy server explicitly you can do so using the --proxy command line parameter. For example:

$ sudo /opt/rstudio-connect/bin/license-manager \
    --proxy=http://127.0.0.1/ activate <product-key>

Proxy settings can include a host-name, port, and username/password if necessary. The following are all valid proxy configurations:

http://127.0.0.1/
http://127.0.0.1:8080/
http://user:pass@127.0.0.1:8080/

If the port is not specified, the license manager will default to using port 1080.

3.2 Offline Activation

If your system has no connection to the internet it’s also possible to perform an offline activation. To do this, you first generate an offline activation request as follows:

$ sudo /opt/rstudio-connect/bin/license-manager activate-offline-request <product-key>

Executing this command will print an offline activation request to the terminal which you should copy and paste and then send to RStudio customer support (support@rstudio.com). You will receive a reply with a file attachment that can be used to activate offline as follows:

$ sudo /opt/rstudio-connect/bin/license-manager activate-offline <activation-file>

After activation, we recommend restarting the RStudio Connect server. A change in license status will eventually be detected by the product; a forced restart ensures that change is seen immediately.

$ sudo stop rstudio-connect
$ sudo start rstudio-connect

Your platform may need alternate commands to restart RStudio Connect. Please see Section 5.1 for instructions specific to your operating system version.

If you want to move your license of RStudio Connect to another system you can also perform license deactivation offline. You can do this as follows:

$ sudo /opt/rstudio-connect/bin/license-manager deactivate-offline

Executing this command will print an offline deactivation request to the terminal which you should copy and paste and then send to RStudio customer support (support@rstudio.com).

You can also perform an offline check of your current license status using the following command:

$ sudo /opt/rstudio-connect/bin/license-manager status-offline