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    

Custom Domains

Your company brand and trust are important to you and your customers, and with custom domains you can present your own company as the endpoint for distribution, APIs and configuration (e.g. retrieving GPG keys).

Whether you're a vendor, selling and distributing software to your customers, or you're a security-conscious DevOps team, looking to control the source endpoint for artifacts; either way, with custom domains you can present your brand when distributing from Cloudsmith.

For API-based package formats, such as NuGet, Docker, Cargo, npm, Conan and Terraform, you can have a specific custom domain, such as docker.yourdomain.com, npm.yourdomain.com or cargo.yourdomain.com.
For other package formats, and downloads in general, you can have a custom domain such as dl.yourdomain.com.

Setup

We can configure custom domains account-wide or on a per-repository basis.

To configure a custom domain within Clousmith, we require you to provide a list of domains you would like to use. Once created within Cloudsmith, you will need to create two DNS CNAME entries for each domain you wish to configure within your DNS provider.

Step1

The process begins when you contact us via support with a list of custom domains you would like to configure. We will review and start processing your request, ensuring your plan is eligible to make use of the custom domain feature.

Step2

After confirming the domains you need, a member of the team will review and configure them within Cloudsmith. Once set, the DNS CNAME entries will be visible in your account (in the "Custom Domains" section of any repository)

Step3

You then add the DNS CNAME entries to your domain DNS records with your DNS provider. The first CNAME is for authorizing the domain, and the second is to make it visible and accessible to your users.

Once you have configured the CNAME's, you will then be able to make use of your custom domains.

Please just contact us if you would like to set this up or require any further information.

Top Level Redirects

You can request that the top-level of your domain (e.g. npm.example.com) redirects to a location of your choice. For example, to the UI for your repositories if public, or to your own customer support page.

If you'd like to configure this, please just Contact Us.

Updated about a month ago


Custom Domains


Suggested Edits are limited on API Reference Pages

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