Export from Cloudsmith

Download packages using the Cloudsmith interface

Cloudsmith offers two options to download specific packages from a Cloudsmith repository through its interface, one of which also involves command execution through a command line interface (CLI):

• To download individual packages, follow Cloudsmith's Download via Website UI guide for either public or private repositories.

• To download packages using native package management tools (for example, npm or gem), follow Cloudsmith's Downloading via Native Package Manager guide. This guide provides details on how to use the Cloudsmith interface to access specific instructions for each native package management tool. These specific instructions then provide guidance on using the relevant native package management's own CLI tools to download packages from Cloudsmith.

Download packages using the Cloudsmith REST API or CLI tool

Cloudsmith does not support downloading packages directly using its REST API or CLI tool.

However, download URLs can be obtained using the Cloudsmith REST API or its command line interface (CLI), which in turn can then be used to download packages from a Cloudsmith repository.

Retrieving download URLs using the REST API

To retrieve the download URL/s for one or more packages in a Cloudsmith repository using the Cloudsmith API:

curl -X GET "https://api.cloudsmith.io/v1/packages/{owner}/{repository}/" \
  -H "X-Api-Key: $CLOUDSMITH_API_KEY" \
  -H 'accept: application/json' | jq '.[].cdn_url'

where:

• {owner} is your Cloudsmith account or organization name.
• {repository} is your Cloudsmith repository name/slug.
• $CLOUDSMITH_API_KEY is your Cloudsmith API key.

The jq '.[].cdn_url command transforms the JSON response from this Cloudsmith REST API query to list the URLs for individual packages, which can then be used to download them from this repository.

Retrieving download URLs using the CLI

To retrieve the download URL/s for one or more packages in a Cloudsmith repository using the Cloudsmith CLI:

cloudsmith list packages {owner}/{repository} -F json | jq -r '.data[].cdn_url'

where:

• {owner} is your Cloudsmith account or organization name.
• {repository} is your Cloudsmith repository name/slug.

The jq -r '.data[].cdn_url command transforms the JSON-formatted response from this Cloudsmith CLI command to list the URLs for individual packages, which can then be used to download them from this repository.

Download a package

Once you have obtained the relevant download URLs (using the REST API or CLI) for packages from your Cloudsmith registry, you can download using the wget command to download them.

To download a package from a public repository:

wget {cdn_url}

where {cdn_url} is the URL of your package to be downloaded.

To download a package from a private repository:

wget -d --header="X-Api-Key: $CLOUDSMITH_API_KEY" {cdn_url} 

where $CLOUDSMITH_API_KEY is your Cloudsmith API key.

Or:

wget --http-user=$account --http-password=$token {cdn_url}

where:

• $account is your Cloudsmith account or organization name.
• $token is an appropriate Cloudsmith entitlement token.

Download packages in bulk

Packages can be downloaded in bulk from a Cloudsmith repository using the Cloudsmith CLI tool, along with some scripting.

Learn more about how to do this from the Bulk Package Download section of Cloudsmith's documentation, which provides scripting examples for Linux (bash) and Windows (PowerShell).

Next step

Once you have downloaded your packages from your Cloudsmith repositories, learn how to import them into your Buildkite registry.