Cloudsmith Documentation Hub

Welcome to the Cloudsmith Documentation 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    

Terraform Modules Repository

Cloudsmith provides public & private repositories for Terraform Modules

Terraform is an infrastructure-as-code tool to provision and manage any cloud, infrastructure, or service by the awesome folks over at Hashicorp.

For more information on Terraform, please see:

Contextual Documentation

The examples in this document are generic. Cloudsmith provides contextual setup instructions within each repository, complete with copy n' paste snippets (with your namespace/repo pre-configured).

In the following examples:




Your Cloudsmith account name or organisation name (namespace)


Your Cloudsmith Repository name (also called "slug")


Your Cloudsmith Entitlement Token (see Entitlements for more details)


Your Cloudsmith username


Your Cloudsmith password


Your Cloudsmith API Key


The name of your Terraform Module


The version number of your Terraform Module

Upload a Module

Upload via the Cloudsmith CLI or Website

To upload via the Cloudsmith API/CLI, you'll need to generate a module first. While we expect the tooling in this area to improve over time, currently the process is a manual one, and can be a little tricky.

You can build a package with standard command-line tooling like tar. To illustrate the process we'll use the terraform vault module for AWS as an example:

First, check out the version of the module we want to pack (0.13.6 for example purposes):

git clone [email protected]:hashicorp/terraform-aws-vault.git
cd terraform-aws-vault
git checkout 0.13.6

Next, create an archive using:

tar --exclude='.terraform' --exclude='*.tfstate*' --exclude='**'-czvf terraform-aws-vault_0.13.6.tar.gz


Please see the official Terraform documentation for more information on building your own modules.

Upload via Cloudsmith CLI

For full details of how to install and setup the Cloudsmith CLI, see Command Line Interface.

The command to upload a Terraform Module via the Cloudsmith CLI is:

cloudsmith push terraform OWNER/REPOSITORY MODULE_NAME-MODULE_VERSION.tar.gz


cloudsmith push terraform demo/examples-repo terraform-aws-vault_0.13.6.tar.gz

Upload via Cloudsmith Website

Please see Upload a Package for details of how to upload via the Website UI.

Download / Install a Module


Assuming you have Terraform already installed (if not, see the official docs), it is straightforward to add a Cloudsmith-based Terraform module.

First, the namespace, repository and credentials must be added to your .terraformrc or terraform.rc file. The token must contain the name of the organization which owns the module, the repository containing the module and the credentials required to authenticate with the API, delimited by a /:

credentials "" {
credentials "" {


Entitlement Tokens, User Credentials and API-Keys should be treated as secrets, and you should ensure that you do not commit them in configurations files along with source code or expose them in any logs.

Install a Module

Once configured as above, your module can then depend on a module from your registry by specifying the module's source in your Terraform file(s) using the syntax as outlined by Terraform:

module "my_module" {
  source = ""
  version = "MODULE_VERSION"


module "my_module" {
  source = ""
  version = "v0.13.6"

Once added, terraform will download the module to your project's .terraform directory after running:

terraform init

You can install the latest version of this crate by removing the version variable from its declaration in your source code.

You can upgrade to the most recent version of this module matching your version constraints by running:

terraform init -upgrade=true

Upstream Proxying / Caching

Not Supported

Key Signing Support

Not Supported by Format


Please see the Troubleshooting page for further help and information.

Updated 25 days ago

Terraform Modules Repository

Cloudsmith provides public & private repositories for Terraform Modules

Suggested Edits are limited on API Reference Pages

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

Cloudsmith is the new standard in Package Management and Software Distribution

With support for all major package formats, you can trust us to manage your software supply chain.

Start My Free Trial Now
Cookie Declaration (Manage Cookies)