The Cloudsmith Developer Hub

Welcome to the Cloudsmith Developer Hub. You'll find comprehensive guides and documentation to help you start working with Cloudsmith as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Upstream Proxying

Upstream proxying and caching allows you to upload and use the packages you own, while Cloudsmith fetches and caches other packages (such as dependencies).

This enables you to use Cloudsmith as a first-class cache and a central source of truth for packages, to protect you from outages of external services (which is especially important when running behind your firewall).

Supported Formats

Fixed Proxy
Configurable Proxy

Note: All formats are on the roadmap for Configurable Proxy and Caching.

Create an Upstream Proxy

Click the green "Create Upstream" button, you will then be presented with the "Create Maven Upstream Source" form:

Form FieldDescription
NameA descriptive name for this upstream source. A shortened version of this name will be used for tagging cached packages retrieved from this upstream.
WeightingThe weighting of the Upstream source. Upstream sources are selected for resolving requests by descending priority (higher to lower), followed by creation date.
Upstream URLThe URL for this upstream source. This must be a fully qualified URL including any path elements required to reach the root of the repository.
Operating ModeBy default, upstream sources proxy requests through to match assets that are not present in this repository. On supported formats, proxy/caching may be selected to store resolved assets in this repository for future requests.
Verify SSL CertificatesIf enabled, SSL certificates are verified when requests are made to this upstream. We recommended leaving this enabled for all public sources to help mitigate Man-In-The-Middle (MITM) attacks.
Authentication Username and
Authentication Password (optional)
Optional credentials that can be provided if the upstream is not publicly accessible
Headers (optional)Optional Key-Value headers that can be passed to upstreams with each request.

Edit an Upstream Proxy

Click the blue "Edit Upstream" button to edit an upstream source:

Disable an Upstream Proxy

Click the orange "Disable Upstream" button to disable an upstream source:

Delete an Upstream Proxy

Click the red "Disable Upstream" button to disable an upstream source:

Prioritization of Upstreams

Upstream Proxy List

Updated about a month ago

Upstream Proxying

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.