Create a Repository

You can create a new repository in three ways:

  • Via the Cloudsmith CLI
  • Via the Website UI
  • Via the Cloudsmith API

Via the Cloudsmith CLI

In the following examples:

IdentifierDescription
OWNERA Cloudsmith organization / workspace / namespace account name
REPO-NAMEA name for your repository. Maximum 50 characters.
REPO-DESCDescription for your Repository
REPO-TYPEThe type of repository - "Public" or "Private"
REPO-IDENTIFIER(Optional) A unique identifier for the repository, also referred to as a 'slug'. This will form part of the URI for your repository. It can only contain lowercase alphanumeric characters, hyphens, and underscores and must be a minimum of 2 characters.

📘

NOTE

If you do not specify a repository identifier, we will generate one for you. We will try to base this on the repository name where possible but may also append some characters to it. If you require a specific repository identifier, we recommend that you do specify one.

Create a REPO-CONFIG.json file with the following:

{
    "name": "REPO-NAME",
    "description": "REPO-DESC",
    "repository_type_str": "REPO-TYPE",
    "slug": "REPO-IDENTIFIER"
}

You can create then a repository via the Cloudsmith CLI using the following command:

cloudsmith repos create OWNER REPO-CONFIG.json

Example

example-repo-config.json file:

{
    "name": "Example Repository",
    "description": "Example packages repository",
    "repository_type_str": "Private",
    "slug": "example-repo1"
}

Create repository command:

cloudsmith repos create demo example-repo-config.json
842

cloudsmith repos create command


Via the Website UI

You can create a repository by navigating to the Repositories overview and clicking the "New repository" button.

1335

That will take you to the "Create a new Repository" form:

892

Here, you simply name your repository and click "Create Repository," and you will create a new private repository.

📘

Multi-Format Repositories

All Cloudsmith repositories are multi-format. This means you can store artifacts of different formats in the same logical grouping. A Maven package can sit beside a Debian package, a Ruby Gem or a Python package!

You can manage your Repository by navigating to your new repository and selecting Settings.

From there, you can manage:

  • General settings
  • Access control
  • Retention rules
  • EULA enforcement
  • GEO / IP rules
  • Key management
  • Webhooks

📘

Changing Repository Settings

The good thing about Cloudsmith is that you can change everything later. The name, slug, description, repository type can all be changed if necessary. Although once shared, if you change the settings or naming you may need to communicate this to all interested parties.

Private Repositories

All paid accounts come with unlimited Private repositories.

Private repositories are private. If required, external access to any files in a private repository is controlled by our Entitlement system. See "How To: Sharing a Private Package" for more details.

Broadcasts

Cloudsmith Broadcasts lets you distribute packages to the public. You can enable broadcasting during repository creation, which will make the packages in the repository available for download without authentication.


Via the Cloudsmith API

For details on how to create a repository via the Cloudsmith API, please see the "Create a Repository" section of the API Reference, including an interactive sandbox where you can test your API Calls.

📘

NOTE

It is not currently possible to create Open Source repositories via the Cloudsmith API.


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)