Integration with RStudio Package Manager#
RStudio Package Manager is a repository management server product that makes it easy to organize and centralize R packages at your organization. RStudio Package Manager may help if your organization needs offline CRAN access, package access restrictions, internal package sharing, or other special package management needs. To learn more, visit the RStudio Package Manager Product Page and contact your RStudio Customer Success Representative.
Overriding CRAN with RStudio Package Manager#
You may wish to redefine CRAN or another R package repository to point to your organization's RStudio Package Manager repository, or at some other private R package repository that you have set up.
When a user deploys R content, the content comes with a
manifest.json file that is used to generate the
This file contains the versions and cryptographic hashes of all the package
dependencies for the content, as well as the URLs of the package repositories
in the deploying user's environment. CRAN is one such repository, and it is
the most commonly used repository for R programming.
You should first obtain the repository link from RStudio Package Manager:
Open RStudio Package Manager
Select your repository in the
Reposlist on the left side of the screen
Setupin the navigation bar at the top of the screen
Repository URL, select whether you want the
Latestcheckpoint or select a date to
Freezethe packages to a particular date.
Freezing your repository to a date could lead to users attempting to deploy content containing package versions that did not exist at that date. If that happens, their content will fail to build because it cannot find necessary packages.
If present on your version of RStudio Package Manager, select whether you want
If you choose binary packages, you must select the distribution that matches the distribution of Linux you are using on RStudio Connect.
Use this URL...link, copy the URL.
/etc/rstudio-connect/rstudio-connect.gcfgconfiguration file, add the following setting, replacing
<the URL you copied>with the URL that you copied in the previous step:
[RPackageRepository "CRAN"] URL = <the URL you copied>
Important: You MUST force your packrat cache to rebuild every time you change this setting. You can accomplish this while the server is shut down by running the migrate utility:
/opt/rstudio-connect/bin/migrate rebuild-packrat --force
The location of the binary and the command line options you need to pass may vary depending on where your installation is located on the filesystem.
For additional information, please see the RStudio Connect Admin Guide - Appendix.