> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/artifact-registry/new-to-artifact-registry/quickstart/r-cran-quickstart.md). # R (CRAN) {% @harness-package-selector/package-selector platforms="%5B%7B%22label%22%3A%22Docker%22%2C%22slug%22%3A%22docker%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fdocker-quickstart%22%7D%2C%7B%22label%22%3A%22Helm%22%2C%22slug%22%3A%22helm%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fhelm-quickstart%22%7D%2C%7B%22label%22%3A%22Helm%20HTTP%22%2C%22slug%22%3A%22helm-http%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fhelm-http-quickstart%22%7D%2C%7B%22label%22%3A%22Generic%22%2C%22slug%22%3A%22generic%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fgeneric-quickstart%22%7D%2C%7B%22label%22%3A%22Raw%20File%22%2C%22slug%22%3A%22raw-file%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fraw-file-quickstart%22%7D%2C%7B%22label%22%3A%22Maven%22%2C%22slug%22%3A%22maven%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fmaven-quickstart%22%7D%2C%7B%22label%22%3A%22Python%22%2C%22slug%22%3A%22python%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fpython-quickstart%22%7D%2C%7B%22label%22%3A%22NPM%22%2C%22slug%22%3A%22npm%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fnpm-quickstart%22%7D%2C%7B%22label%22%3A%22Nuget%22%2C%22slug%22%3A%22nuget%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fnuget-quickstart%22%7D%2C%7B%22label%22%3A%22RPM%22%2C%22slug%22%3A%22rpm%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Frpm-quickstart%22%7D%2C%7B%22label%22%3A%22Debian%22%2C%22slug%22%3A%22debian%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fdebian-quickstart%22%7D%2C%7B%22label%22%3A%22Alpine%22%2C%22slug%22%3A%22alpine%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Falpine-quickstart%22%7D%2C%7B%22label%22%3A%22Wolfi%22%2C%22slug%22%3A%22wolfi%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fwolfi-quickstart%22%7D%2C%7B%22label%22%3A%22Cargo%22%2C%22slug%22%3A%22cargo%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fcargo-quickstart%22%7D%2C%7B%22label%22%3A%22Conan%22%2C%22slug%22%3A%22conan%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fconan-quickstart%22%7D%2C%7B%22label%22%3A%22Go%22%2C%22slug%22%3A%22go%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fgo-quickstart%22%7D%2C%7B%22label%22%3A%22Hugging%20Face%22%2C%22slug%22%3A%22hugging-face%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fhugging-face-quickstart%22%7D%2C%7B%22label%22%3A%22Conda%22%2C%22slug%22%3A%22conda%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fconda-quickstart%22%7D%2C%7B%22label%22%3A%22Dart%22%2C%22slug%22%3A%22dart%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fdart-quickstart%22%7D%2C%7B%22label%22%3A%22PHP%20Composer%22%2C%22slug%22%3A%22php-composer%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fphp-composer-quickstart%22%7D%2C%7B%22label%22%3A%22Swift%22%2C%22slug%22%3A%22swift%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fswift-quickstart%22%7D%2C%7B%22label%22%3A%22Puppet%22%2C%22slug%22%3A%22puppet%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fpuppet-quickstart%22%7D%2C%7B%22label%22%3A%22Terraform%22%2C%22slug%22%3A%22terraform%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fterraform-quickstart%22%7D%2C%7B%22label%22%3A%22R%20(CRAN)%22%2C%22slug%22%3A%22r-cran%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fr-cran-quickstart%22%7D%2C%7B%22label%22%3A%22RubyGems%22%2C%22slug%22%3A%22rubygems%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Frubygems-quickstart%22%7D%5D" selectedPlatform="r-cran" %} Use an **CRAN** registry to host private R packages that follow the CRAN package format, and optionally cache packages from public CRAN mirrors through an upstream proxy. *** ### Before you begin * Ensure you have **R** installed on your local machine, including the standard package tools (`install.packages`). * Access to a Harness account with appropriate permissions to create registries and connectors. *** ### Create a CRAN artifact registry 1. Go to the Artifact Registry module in your Harness project. 2. Click **New Artifact Registry**. 3. In the Registry Type list, select **CRAN**. 4. Enter a **Registry Name**.

REGISTRY NAME CRITERIA

The registry name must start with a letter, should only contain lowercase alphanumerics, _, . and -, and must be unique to your Harness account.

5. Optionally, add a Description and Labels for better organization. 6. Choose visibility between **Public** and **Private**. *By default, the visibility is set to Private*. 7. Select **Create Registry** to finalize. *** ### Configure an upstream proxy (optional) An upstream proxy allows your registry to fetch R packages from external CRAN-compatible repositories when they are not available locally. The default upstream is `https://cran.r-project.org`. #### Create an upstream proxy 1. In the Artifact Registry module, select the dropdown next to **New Artifact Registry** and select **Upstream Proxy**. 2. Select **CRAN** as the proxy type. 3. Enter an **Upstream Proxy Key**. 4. Optionally, add a Description and Labels. 5. Select your **Source**: * CRAN * Custom 6. If you choose Custom, enter your **Remote Registry URL** (for example, `https://cran.r-project.org`). 7. Choose your **Authentication** method (`Anonymous` by default for public CRAN mirrors). 8. Click **Create Upstream Proxy** to establish the connection. #### Configure the upstream proxy in your registry 1. In the Artifact Registry module, select an existing R (CRAN) Artifact Registry. 2. Go to the **Configuration** tab. 3. In the **Advanced (Optional)** section, click **Configure Upstream**. 4. Select from the list of compatible proxies to add them to your registry. 5. Select **Save** to save the configuration. {% hint style="info" %} **UPSTREAM PROXY CACHING** If a package is not found in your Harness registry, the upstream proxy fetches it from the remote CRAN-compatible repository and caches it. {% endhint %} *** ### Set up the CRAN Package client In your Harness CRAN Artifact Registry, click **Set Up Client** and follow the instructions to install or use R packages from the registry. **1. Generate identity token** 1. In your Harness CRAN Artifact Registry, click **Set Up Client**. 2. Click **Generate Token** to generate an identity token. **2. Configure R** * Point R at this registry as a CRAN-like repository. 1. Set the repository for the current R session: ```bash options( repos = c( HARNESS = "https://pkg.harness.io/pkg///cran" )) ``` 2. Persist across sessions by appending the same line to \~/.Rprofile: ```bash echo 'options(repos = c(HARNESS = "https://pkg.harness.io/pkg///cran"))' >> ~/.Rprofile ``` 3. Route downloads through libcurl and attach the identity token: ```bash options(download.file.method = "libcurl", download.file.extra = "-H 'x-api-key: '") ``` **3. Install a package** ```bash install.packages("") ``` **4. Install an archived (older) version** * The live index only lists the latest version of a package. Superseded source versions are still downloadable from the Archive/ path. Install a specific version using the 'remotes' package: ```bash remotes::install_version("", version = "", repos = "https://pkg.harness.io/pkg///cran") ``` OR install directly from the archived source tarball: ```bash install.packages("https://pkg.harness.io/pkg///cran/src/contrib/Archive//_.tar.gz", repos = NULL, type = "source") ``` **5. Upload a package** * Upload an R source or binary archive to the registry using the CRAN repository layout. 1. Upload a source package to src/contrib (produced by 'R CMD build'): ```bash curl --location --request PUT 'https://pkg.harness.io/pkg///files/src/contrib/' \ --header 'x-api-key: ' \ --upload-file '' ``` 2. Upload a Windows binary to `bin/windows/contrib/` (for example, `4.4`): ```bash curl --location --request PUT 'https://pkg.harness.io/pkg///files/bin/windows/contrib//' \ --header 'x-api-key: ' \ --upload-file '' ``` 3. Upload a macOS binary to `bin/macosx//contrib/` (for example, `big-sur-arm64`, `4.4`): ```bash curl --location --request PUT 'https://pkg.harness.io/pkg///files/bin/macosx//contrib//' \ --header 'x-api-key: ' \ --upload-file '' ``` *** ### Troubleshooting
install.packages fails with 401 or 403 against an R (CRAN) registry Confirm the identity token is set via download.file.extra (-H 'x-api-key: '), regenerate the token from Set Up Client if needed, and verify your principal has Artifact Registry Contributor or Admin permissions on the registry.