Conda Repository

Cloudsmith provides public & private repositories for Conda

Conda is a cross-platform, language-agnostic binary package manager. It is the package manager used by Anaconda installations.

For more information on Conda, please see:

🚧

Beta Availability

Conda Support is currently in Beta and we welcome your feedback for improvements

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/rsa-key pre-configured).

In the following examples:

IdentifierDescription
OWNERYour Cloudsmith account name or organization name (namespace)
REPOSITORYYour Cloudsmith Repository name (also called "slug")
TOKENYour Cloudsmith Entitlement Token (see Entitlements for more details)
USERNAMEYour Cloudsmith username
PASSWORDYour Cloudsmith password
API-KEYYour Cloudsmith API Key
PACKAGE_NAMEThe name of your package
PACKAGE_VERSIONThe version number of your package

Upload a Package

Creating Conda Packages

To upload via the Cloudsmith API/CLI, you'll need to generate a package first. You can do this with conda-build:

conda build .

This generates a .tar.bz2 file like your-package-0.1.0.tar.bz2 that you can upload.

Upload via the Cloudsmith CLI

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

The command to upload Conda package via the Cloudsmith CLI is:

cloudsmith push conda OWNER/REPOSITORY PACKAGE_NAME-PACKAGE_VERSION.tar.bz2

Example:

cloudsmith push conda my-org/my-repo your-package-0.1.0.tar.bz2

Upload via Cloudsmith Website

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


Download / Install a Package

Setup

Public Repositories

Adding a new channel can be accomplished by using the conda CLI:

conda config --add channels https://conda.cloudsmith.io/OWNER/REPOSITORY/

Alternatively, the channel can be added directly to your .condarc:

channels:
  - https://conda.cloudsmith.io/OWNER/REPOSITORY/
  - defaults

Or if you prefer, directly in your environment.yml file:

name: env-name
channels:
  - https://conda.cloudsmith.io/OWNER/REPOSITORY/
  - defaults
dependencies:
  - python=3.7
  - codecov

Private Repositories

📘

Private Cloudsmith repositories require authentication. You can choose between two types of authentication, Entitlement Token Authentication or HTTP Basic Authentication.

The setup method will differ depending on what authentication type you choose to use.

🚧

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

Adding a new channel can be accomplished by using the conda CLI:

conda config --add channels https://USERNAME:[email protected]/OWNER/REPOSITORY/
conda config --add channels https://USERNAME:[email protected]/OWNER/REPOSITORY/
conda config --add channels https://token:[email protected]/OWNER/REPOSITORY/

Alternatively, the channel can be added directly to your .condarc:

channels:
  - https://USERNAME:[email protected]/OWNER/REPOSITORY/
  - defaults
channels:
  - https://USERNAME:[email protected]/OWNER/REPOSITORY/
  - defaults
channels:
  - https://token:[email protected]/OWNER/REPOSITORY/
  - defaults

Or if you prefer, directly in your environment.yml file:

name: env-name
channels:
  - https://USERNAME:[email protected]/OWNER/REPOSITORY/
  - defaults
dependencies:
  - python=3.7
  - codecov
name: env-name
channels:
  - https://USERNAME:[email protected]/OWNER/REPOSITORY/
  - defaults
dependencies:
  - python=3.7
  - codecov
name: env-name
channels:
  - https://token:[email protected]/OWNER/REPOSITORY/
  - defaults
dependencies:
  - python=3.7
  - codecov

Install a Package

Once configured, you can install packages from your channel using the conda CLI:

conda install your-package=1.2.3

Cloudsmith is the new standard in Package / Artifact 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)