Need your own package repository for Alpine, Cargo, CocoaPods, Composer, Conan, CRAN, Dart, Debian, Docker, Go, Helm, LuaRocks, Maven, npm, NuGet, Python, RedHat, Ruby, Terraform, Vagrant, Raw & More?

Cloudsmith provides better DevOps with simple and secure delivery of your software, from dev to production.

Start My Free 7-Day Trial
Set Me Up
 Open-Source — cloudsmith cloudsmith (Cloudsmith) / cli —  GitHub Project
Official repository for the Cloudsmith CLI application.
These tend to be pre-releases, for stable releases download from PyPi: https://pypi.python.org/pypi/cloudsmith-cli
Note: Packages in this repository are licensed as Apache License 2.0 (dependencies may be licensed differently).
Packages 102 Package Groups 2 Signing Keys

Table of Contents

Format-Specific Setup

To find out how to get setup locally so you can easily install packages, please select one of the formats from the tabs above.

Please note that the term repository here is Cloudsmith's concept of a package or artefact collection, and should not be confused with other package format specific meanings (such as the term as it is used by Docker, to mean a tagged image).

Note: Only help for package formats that exist in this repository is shown. You can also see the help for all package formats.

Need Help?

If you couldn't find what you needed in our documentation, then you can always chat to a member of our team instead. It's our mission to be your dedicated off-site team for package management, and we mean it. Come and chat with us, anytime.

Python logo

Python Repository Setup

Pip/Pipenv/Poetry are package managers of choice for the Python ecosystem. Cloudsmith is fully compatible as a PyPi-like repository.

The following instructions are for Python or compatible packages only.

Python Setup Via Command-Line

You can install packages directly by using the --index-url or --extra-index-url Pip configuration arguments when executing a pip command. We recommend using --index-url - see our documentation for more information. 

pip install my-awesome-package==1.0.0 --index-url https://dl.cloudsmith.io/public/cloudsmith/cli/python/simple/

Using the configuration argument --index-url will result in Pip only searching your Cloudsmith repository and will not be able to install public (PyPi) packages that your private package may depend on. If you wish to fallback on public packages at PyPi you can append the following pip argument --extra-index-url https://pypi.org/simple 

pip install my-awesome-package==1.0.0 --index-url https://dl.cloudsmith.io/public/cloudsmith/cli/python/simple/

Note: You'll need to replace my-awesome-package and 1.0.0 with your own awesome python packages and versions.

Python Setup Via Pip

Similar to setup via command-line, pip needs to be passed the --index-url configuration option. To do this add --index-url to the top of your requirements.txt (or similar) file. 

--index-url https://dl.cloudsmith.io/public/cloudsmith/cli/python/simple/
my-awesome-package==1.0.0

Note: You'll need to replace my-awesome-package and 1.0.0 with your own awesome python packages and versions.

Removing Setup

If you no longer want to install packages from the repository, you can remove it with:

Remove the following line from your $HOME/.pip/pip.conf file: 

--index-url=https://dl.cloudsmith.io/public/cloudsmith/cli/python/simple/

Need Help?

If you couldn't find what you needed in our documentation, then you can always chat to a member of our team instead. It's our mission to be your dedicated off-site team for package management, and we mean it. Come and chat with us, anytime.

What's this page? You can always download packages from Cloudsmith manually, but native package manager setup allows you to simplify and automate downloads. A native package manager has intelligence built-in that allows it to understand concepts like metadata, versioning, duplication, convergence, etc. As such, we will always recommend that you install natively where possible. Learn more in the setup documentation.

Top