Apt/Dpkg is the package manager of choice for Debian-like systems (such as Ubuntu, Linux Mint, Raspbian, etc.)

The following instructions are for Debian or compatible packages only.

To install packages, you can quickly setup the repository automatically (recommended):

curl -1sLf \
  'https://dl.cloudsmith.io/public/cloudsmith/love-open-source/setup.deb.sh' \
  | sudo -E bash

If you need to force a specific distribution, release/version, architecture, or component (if supported), you can also do that (e.g. if your system is compatible but not identical):

curl -1sLf \
  'https://dl.cloudsmith.io/public/cloudsmith/love-open-source/setup.deb.sh' \
  | sudo -E distro=DISTRO codename=CODENAME arch=ARCH component=COMPONENT bash

or ... you can manually configure it yourself before installing packages:

apt-get install -y debian-keyring  # debian only
apt-get install -y debian-archive-keyring  # debian only
apt-get install -y apt-transport-https
# For Debian Stretch, Ubuntu 16.04 and later
keyring_location=/usr/share/keyrings/cloudsmith-love-open-source-archive-keyring.gpg
# For Debian Jessie, Ubuntu 15.10 and earlier
keyring_location=/etc/apt/trusted.gpg.d/cloudsmith-love-open-source.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/cloudsmith/love-open-source/gpg.C8BD3877C0529188.key' |  gpg --dearmor >> ${keyring_location}
curl -1sLf 'https://dl.cloudsmith.io/public/cloudsmith/love-open-source/config.deb.txt?distro=ubuntu&codename=xenial&component=main' > /etc/apt/sources.list.d/cloudsmith-love-open-source.list
apt-get update

Note: Please replace ubuntu, xenial and main above with your actual operating system (distribution and distribution release/version) and components (based on what's in this repository).

rm /etc/apt/sources.list.d/cloudsmith-love-open-source.list
apt-get clean
rm -rf /var/lib/apt/lists/*
apt-get update

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.

A repository that supports Maven-compatible projects and JARs, with support for Gradle, SBT, Leiningen, Ivy, Grape, etc.

The following instructions are for Maven or compatible packages only.

• Maven
• Gradle
• Sbt/Scala
• Leiningen/Clojure
• Grape

<repositories>
  <repository>
    <id>cloudsmith-love-open-source</id>
    <url>https://dl.cloudsmith.io/public/cloudsmith/love-open-source/maven/</url>
    <releases>
      <enabled>true</enabled>
      <updatePolicy>always</updatePolicy>
    </releases>
    <snapshots>
      <enabled>true</enabled>
      <updatePolicy>always</updatePolicy>
    </snapshots>
  </repository>
</repositories>

<dependency>
  <groupId>group-id</groupId>
  <artifactId>artifact-id</artifactId>
  <version>version</version>
</dependency>

repositories {
  maven {
    url "https://dl.cloudsmith.io/public/cloudsmith/love-open-source/maven/"

  }
}

dependencies {
  implementation 'group-id:artifact-id:version'
}

resolvers += "cloudsmith-love-open-source" at "https://dl.cloudsmith.io/public/cloudsmith/love-open-source/maven/"

libraryDependencies += "group-id" % "artifact-id" % "version"

addMavenResolverPlugin

:repositories [["snapshots" "https://dl.cloudsmith.io/public/cloudsmith/love-open-source/maven/"]
               ["releases" "https://dl.cloudsmith.io/public/cloudsmith/love-open-source/maven/"]]

:dependencies [[group-id/artifact-id "version"]]

@GrabResolver(name='cloudsmith-love-open-source', root='https://dl.cloudsmith.io/public/cloudsmith/love-open-source/maven/')

@Grab(group='group-id', module='artifact-id', version='version')

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.

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.

You can install packages directly by using the --index-url or --extra-index-url Pip configuration arguments when executing a pip command.

Note: We recommend using --index-url. As per pip's documentation: Using the --extra-index-url option to search for packages that are not in this repository (such as private packages) is unsafe, per a security vulnerability called dependency confusion: an attacker can claim the package on the public repository in a way that will ensure it gets chosen over the private package. For more detail, see our expanded documentation on the usage and dangers of extra index URL.

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

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

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/love-open-source/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.

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

--index-url=https://dl.cloudsmith.io/public/cloudsmith/love-open-source/python/simple/

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.

A repository for RedHat-like systems (such as RHEL, CentOS, SUSE, Fedora, etc.), compatible with yum, dnf, zypper, etc.

The following instructions are for RedHat or compatible packages only.

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.

Rubygems/bundler are the package managers of choice for the Ruby ecosystem. Cloudsmith is fully compatible as a Rubygems-like repository.

The following instructions are for Ruby or compatible packages only.

As stated by Bundler, "Bundler provides a consistent environment for Ruby projects by tracking and installing the exact gems and versions that are needed."

Bundler from version 1.7 supports scoped sources, so you can install a gem from Cloudsmith using the following declaration in your Gemfile:

source 'https://dl.cloudsmith.io/public/cloudsmith/love-open-source/ruby/' do
  gem 'awesome-gem', '~> 42.0'
end

Note: You'll need to replace awesome-gem and ~> 42.0 with your own gem name and version.

You can also add Cloudsmith as a source for the Ruby CLI instead:

gem sources --add 'https://dl.cloudsmith.io/public/cloudsmith/love-open-source/ruby/'

gem sources -r 'https://dl.cloudsmith.io/public/cloudsmith/love-open-source/ruby/'

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.

Cloudsmith is fully compatible as an (Hashicorp) Atlas-like repository.

The following instructions are for Vagrant or compatible packages only.

To enable the retrieval of Cloudsmith hosted Vagrant boxes, the box can either be added directly via Vagrant's CLI or the project's Vagrantfile can be updated. To add the box directly via Vagrant's CLI, execute the following:

vagrant box add 'https://dl.cloudsmith.io/public/cloudsmith/love-open-source/vagrant/awesome-box/metadata.json' \
  --name 'awesome-box' \
  --box-version 'box-version' \
  --provider 'box-provider'

Note: You'll need to replace awesome-box, box-version and box-provider with your own uploaded package details.

To add the box without having to specify the URL each time, the following must be added to the project's Vagrantfile:

config.vm.box = "awesome-box"
config.vm.box_url = "https://dl.cloudsmith.io/public/cloudsmith/love-open-source/vagrant/awesome-box/metadata.json"

Note: You'll need to replace awesome-box with your own uploaded package details.

After this configuration has been added to the Vagrantfile, Vagrants CLI tool can now be used as normal:

vagrant up
(out)Bringing machine 'default' up with 'box-provider' provider...
(out)  ==> default: Box 'awesome-box' could not be found. Attempting to find and install...
(out)      default: Box Provider: 'box-provider'
(out)      default: Box Version: >= '0'
(out)  ==> default: Loading metadata for box 'https://dl.cloudsmith.io/public/cloudsmith/love-open-source/vagrant/awesome-box/metadata.json'
(out)      default: URL: https://dl.cloudsmith.io/public/cloudsmith/love-open-source/vagrant/awesome-box/box-version/my-awesome-box.box
(out)  ==> default: Adding box 'awesome-box' ('box-version') for provider: 'box-provider'
(out)  ==> default: Successfully added box 'awesome-box' ('box-version') for: 'box-provider'

Note: You'll need to replace awesome-box, box-version and box-provider with your own uploaded package details.

After this configuration has been added to the Vagrantfile new versions will be automatically detected by Vagrant when uploaded to Cloudsmith:

vagrant up
(out)Bringing machine 'default' up with 'box-provider' provider...
(out)  ==> default: Checking if box 'awesome-box' is up to date...
(out)  ==> default: A newer version of the box 'awesome-box' is available! You currently
(out)  ==> default: have version 'box-version'. The latest is version 'my-new-awesome-box-version'. Run
(out)  ==> default: `vagrant box update` to update.
(out)[snip]
vagrant box update
(out)  ==> default: Checking for updates to 'awesome-box'
(out)      default: Latest installed version: 'box-version'
(out)      default: Version constraints:
(out)      default: Provider: 'box-provider'
(out)  ==> default: Updating 'awesome-box' with provider 'box-provider' from version
(out)  ==> default: 'box-version' to 'my-new-awesome-box-version'...
(out)  ==> default: Loading metadata for box 'https://dl.cloudsmith.io/public/cloudsmith/love-open-source/vagrant/awesome-box/metadata.json
(out)  ==> default: Adding box 'awesome-box' ('my-new-awesome-box-version') for provider: 'box-provider'
(out)  ==> default: Successfully added box 'awesome-box' ('my-new-awesome-box-version') for: 'box-provider'

Note: You'll need to replace awesome-box, box-version and box-provider with your own uploaded package details.

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.

A repository that acts like a container for any type of files. Think DropBox, but with a pinch more awesome.

The following instructions are for Raw or compatible packages only.

The purpose of raw files depends on the content of the raw file, which Cloudsmith doesn't know, so we can't provide you with an automated setup method (yet), but it might be as simple as downloading the file.

You can download a raw file using the browser, or if you're running Linux you can use standard tools such as curl.

curl -1sLf -O 'https://dl.cloudsmith.io/public/cloudsmith/love-open-source/raw/files/your-package.zip'

Note: You'll need to replace your-package.zip with your own equally fantastic file name.

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.