# Cloudsmith Documentation

> The universal artifact registry for secure software distribution and dependency management. Full content dump: https://docs.cloudsmith.com/llms-full.txt

[Cloudsmith Documentation](https://docs.cloudsmith.com): The universal artifact registry for secure software distribution and dependency management.

- [Documentation](https://docs.cloudsmith.com/about-cloudsmith)
  - [About Cloudsmith](https://docs.cloudsmith.com/about-cloudsmith)
    - [Key Concepts](https://docs.cloudsmith.com/about-cloudsmith/key-concepts)
    - [Common Use Cases](https://docs.cloudsmith.com/about-cloudsmith/common-use-cases)
    - [Sign Up](https://docs.cloudsmith.com/about-cloudsmith/sign-up)
    - [Log In](https://docs.cloudsmith.com/about-cloudsmith/sign-in)
  - [Supported Formats](https://docs.cloudsmith.com/formats)
    - [Alpine](https://docs.cloudsmith.com/formats/alpine-repository)
    - [Cargo](https://docs.cloudsmith.com/formats/cargo-registry)
    - [Chocolatey](https://docs.cloudsmith.com/formats/chocolatey-repository)
    - [Cocoapods](https://docs.cloudsmith.com/formats/cocoapods-repository)
    - [Composer](https://docs.cloudsmith.com/formats/composer-repository)
    - [Conan](https://docs.cloudsmith.com/formats/conan-repository)
    - [Conda](https://docs.cloudsmith.com/formats/conda-repository)
    - [CRAN](https://docs.cloudsmith.com/formats/cran-repository)
    - [Dart](https://docs.cloudsmith.com/formats/dart-repository)
    - [Debian](https://docs.cloudsmith.com/formats/debian-repository)
    - [Docker](https://docs.cloudsmith.com/formats/docker-registry)
    - [Generic](https://docs.cloudsmith.com/formats/generic-repository)
    - [Go](https://docs.cloudsmith.com/formats/go-registry)
    - [Hugging Face](https://docs.cloudsmith.com/formats/hugging-face-repository)
    - [Gradle](https://docs.cloudsmith.com/formats/gradle-repository)
    - [Helm](https://docs.cloudsmith.com/formats/helm-chart-repository)
    - [Hex](https://docs.cloudsmith.com/formats/hex-repository)
    - [LuaRocks](https://docs.cloudsmith.com/formats/luarocks-repository)
    - [Maven](https://docs.cloudsmith.com/formats/maven-repository)
    - [npm](https://docs.cloudsmith.com/formats/npm-registry)
    - [NuGet Feed](https://docs.cloudsmith.com/formats/nuget-feed)
      - [NuGet Symbol Server](https://docs.cloudsmith.com/formats/nuget-symbol-server)
    - [OCI](https://docs.cloudsmith.com/formats/oci-repository)
    - [PowerShell Modules](https://docs.cloudsmith.com/formats/powershell-modules-repository)
    - [Python](https://docs.cloudsmith.com/formats/python-repository)
    - [Raw](https://docs.cloudsmith.com/formats/raw-repository)
    - [RedHat](https://docs.cloudsmith.com/formats/redhat-repository)
    - [Ruby](https://docs.cloudsmith.com/formats/ruby-repository)
    - [sbt](https://docs.cloudsmith.com/formats/sbt-repository)
    - [Swift](https://docs.cloudsmith.com/formats/swift-registry)
      - [Signing Swift Packages](https://docs.cloudsmith.com/formats/signing-swift-packages)
    - [Terraform](https://docs.cloudsmith.com/formats/terraform-modules-repository)
    - [Unity](https://docs.cloudsmith.com/formats/unity-registry)
    - [Vagrant](https://docs.cloudsmith.com/formats/vagrant-repository)
  - [Workspaces](https://docs.cloudsmith.com/workspaces)
    - [Create a Workspace](https://docs.cloudsmith.com/workspaces/workspace-create)
    - [Workspace Overview](https://docs.cloudsmith.com/workspaces/overview)
    - [Settings](https://docs.cloudsmith.com/workspaces/workspace-settings)
    - [Privileges](https://docs.cloudsmith.com/workspaces/privileges)
    - [Personalization](https://docs.cloudsmith.com/workspaces/personalization)
    - [Custom Domains](https://docs.cloudsmith.com/workspaces/custom-domains)
    - [Authentication](https://docs.cloudsmith.com/authentication)
      - [SAML](https://docs.cloudsmith.com/authentication/single-sign-on)
        - [SSO with Microsoft Entra ID](https://docs.cloudsmith.com/authentication/single-sign-on-with-entra-id)
        - [SSO with Google](https://docs.cloudsmith.com/authentication/single-sign-on-with-google-g-suite)
        - [SSO with JumpCloud](https://docs.cloudsmith.com/authentication/single-sign-on-with-jumpcloud)
        - [SSO with PingIdentity](https://docs.cloudsmith.com/authentication/single-sign-on-with-pingidentity)
        - [SSO with Okta](https://docs.cloudsmith.com/authentication/single-sign-on-with-okta)
        - [SSO with OneLogin](https://docs.cloudsmith.com/authentication/single-sign-on-with-onelogin)
      - [SCIM](https://docs.cloudsmith.com/authentication/scim)
        - [SCIM with Google](https://docs.cloudsmith.com/authentication/scim-with-google)
        - [SCIM with JumpCloud](https://docs.cloudsmith.com/authentication/scim-with-jumpcloud)
        - [SCIM with Microsoft](https://docs.cloudsmith.com/authentication/scim-with-microsoft-entra-id)
        - [SCIM with Okta](https://docs.cloudsmith.com/authentication/scim-with-okta)
        - [SCIM with OneLogin](https://docs.cloudsmith.com/authentication/scim-with-onelogin)
        - [SCIM with PingIdentity](https://docs.cloudsmith.com/authentication/scim-with-pingidentity)
      - [2FA](https://docs.cloudsmith.com/authentication/two-factor-authentication)
      - [OpenID Connect](https://docs.cloudsmith.com/authentication/openid-connect)
        - [GitHub Actions](https://docs.cloudsmith.com/authentication/setup-cloudsmith-to-authenticate-with-oidc-in-github-actions)
        - [Jenkins](https://docs.cloudsmith.com/authentication/setup-jenkins-to-authenticate-to-cloudsmith-using-oidc)
  - [Repositories](https://docs.cloudsmith.com/repositories)
    - [Create a Repository](https://docs.cloudsmith.com/repositories/create-a-repository)
    - [Settings](https://docs.cloudsmith.com/repositories/repository-settings)
    - [Custom Storage Regions](https://docs.cloudsmith.com/repositories/custom-storage-regions)
    - [Upstreams](https://docs.cloudsmith.com/repositories/upstreams)
    - [Connected Repositories](https://docs.cloudsmith.com/repositories/connected-repositories)
    - [Privileges](https://docs.cloudsmith.com/repositories/repository-privileges)
  - [Teams and Accounts](https://docs.cloudsmith.com/accounts-and-teams)
    - [Teams](https://docs.cloudsmith.com/accounts-and-teams/teams)
    - [Member Accounts](https://docs.cloudsmith.com/accounts-and-teams/user-accounts)
    - [API Keys](https://docs.cloudsmith.com/accounts-and-teams/api-key)
    - [Service Accounts](https://docs.cloudsmith.com/accounts-and-teams/service-accounts)
    - [Privileges](https://docs.cloudsmith.com/accounts-and-teams/about-privileges)
  - [Artifact Management](https://docs.cloudsmith.com/artifact-management)
    - [Package Actions](https://docs.cloudsmith.com/artifact-management#package-actions)
    - [Package Search Syntax](https://docs.cloudsmith.com/artifact-management/search-filter-sort-packages)
    - [Retention Rules](https://docs.cloudsmith.com/artifact-management/retention-rules)
    - [Package Groups](https://docs.cloudsmith.com/artifact-management/package-groups)
    - [Troubleshooting](https://docs.cloudsmith.com/resources/troubleshooting)
    - [Recently Deleted Packages](https://docs.cloudsmith.com/artifact-management/recently-deleted-packages)
  - [Supply Chain Security](https://docs.cloudsmith.com/supply-chain-security)
    - [Block Until Scan](https://docs.cloudsmith.com/policy-management/block-until-scan)
    - [Continuous Security](https://docs.cloudsmith.com/supply-chain-security/continuous-security)
    - [Vulnerability Scanning](https://docs.cloudsmith.com/supply-chain-security/vulnerability-scanning)
    - [Policies](https://docs.cloudsmith.com/policy-management)
      - [Vulnerability Policy](https://docs.cloudsmith.com/policy-management/vulnerability-policy)
      - [Deny Policy](https://docs.cloudsmith.com/policy-management/deny-policy)
      - [API Key Policy](https://docs.cloudsmith.com/policy-management/api-key-policy)
      - [License Policy](https://docs.cloudsmith.com/policy-management/license-policy)
      - [Geo/IP Rules](https://docs.cloudsmith.com/policy-management/geoip-rules)
    - [Enterprise Policy Manager](https://docs.cloudsmith.com/supply-chain-security/epm)
      - [Getting Started](https://docs.cloudsmith.com/supply-chain-security/epm/getting-started)
      - [Rego Recipes](https://docs.cloudsmith.com/supply-chain-security/epm/rego)
      - [EPM Workflow Example](https://docs.cloudsmith.com/supply-chain-security/epm/tag-addition-removal-flow)
      - [Cooldown Policy](https://docs.cloudsmith.com/supply-chain-security/epm/cooldown-policy)
    - [Malware Detection](https://docs.cloudsmith.com/supply-chain-security/malware-detection)
      - [Malware Scanning](https://docs.cloudsmith.com/supply-chain-security/malware-detection/malware-scanning)
      - [Malicious Packages](https://docs.cloudsmith.com/supply-chain-security/malware-detection/malicious-packages)
    - [Package Signing](https://docs.cloudsmith.com/supply-chain-security/signing-keys)
    - [License Compliance](https://docs.cloudsmith.com/policy-management/license-compliance)
    - [Upstream Trust](https://docs.cloudsmith.com/supply-chain-security/upstream-trust)
  - [Observability and Logs](https://docs.cloudsmith.com/logs-and-observability)
    - [Client Logs](https://docs.cloudsmith.com/logs-and-observability/client-logs)
    - [Audit Logs](https://docs.cloudsmith.com/logs-and-observability/audit-logs)
    - [Usage](https://docs.cloudsmith.com/logs-and-observability/usage)
    - [Exporting Logs to Azure](https://docs.cloudsmith.com/logs-and-observability/exports-to-azure)
    - [Exporting Logs to S3](https://docs.cloudsmith.com/logs-and-observability/access-log-exports-to-s3)
    - [Analyzing Logs with Athena](https://docs.cloudsmith.com/logs-and-observability/analyzing-s3-download-logs)
  - [Software Distribution](https://docs.cloudsmith.com/software-distribution)
    - [Broadcasts](https://docs.cloudsmith.com/software-distribution/broadcasts)
      - [Customization](https://docs.cloudsmith.com/software-distribution/broadcasts/broadcasts-customization)
      - [Private Broadcasts](https://docs.cloudsmith.com/software-distribution/broadcasts/private-broadcasts)
    - [Entitlement Tokens](https://docs.cloudsmith.com/software-distribution/entitlement-tokens)
      - [Via the API](https://docs.cloudsmith.com/software-distribution/entitlement-tokens-via-the-cloudsmith-api)
      - [Via the CLI](https://docs.cloudsmith.com/software-distribution/entitlement-tokens-via-the-cloudsmith-cli)
      - [Via web app](https://docs.cloudsmith.com/software-distribution/entitlement-tokens-via-the-website-ui)
    - [EULA Enforcement](https://docs.cloudsmith.com/software-distribution/eula)
  - [Integrations](https://docs.cloudsmith.com/integrations)
    - [Aikido](https://docs.cloudsmith.com/integrations/integrating-with-aikido)
    - [Ansible](https://docs.cloudsmith.com/integrations/integrating-with-ansible)
    - [ArgoCD](https://docs.cloudsmith.com/integrations/integrating-with-argocd)
    - [AWS CodeBuild](https://docs.cloudsmith.com/integrations/integrating-with-aws-codebuild)
    - [AWS SageMaker](https://docs.cloudsmith.com/integrations/integrating-with-aws-sagemaker)
    - [Azure DevOps](https://docs.cloudsmith.com/integrations/integrating-with-azure-devops)
    - [Bitbucket Pipelines](https://docs.cloudsmith.com/integrations/integrating-with-bitbucket-pipelines)
    - [Buildkite](https://docs.cloudsmith.com/integrations/integrating-with-buildkite)
    - [Chainguard Images](https://docs.cloudsmith.com/integrations/integrating-with-chainguard-images)
    - [Chef](https://docs.cloudsmith.com/integrations/integrating-with-chef)
    - [CircleCI](https://docs.cloudsmith.com/integrations/integrating-with-circleci)
    - [Codefresh](https://docs.cloudsmith.com/integrations/integrating-with-codefresh)
    - [Cursor IDE](https://docs.cloudsmith.com/developer-tools/vscode)
    - [Datadog](https://docs.cloudsmith.com/integrations/integrating-with-datadog)
    - [Dependabot](https://docs.cloudsmith.com/integrations/integrating-with-dependabot)
    - [Docker Hardened Images](https://docs.cloudsmith.com/integrations/integrating-with-docker-hardened-images)
    - [Docker Hub](https://docs.cloudsmith.com/integrations/integrating-with-docker-hub)
    - [Drone CI](https://docs.cloudsmith.com/integrations/integrating-with-drone-ci)
    - [GitHub Actions](https://docs.cloudsmith.com/integrations/integrating-with-github-actions)
    - [GitLab CI/CD](https://docs.cloudsmith.com/integrations/integrating-with-gitlab-cicd)
    - [Harness CD](https://docs.cloudsmith.com/integrations/integrating-with-harnesscd)
    - [Jenkins](https://docs.cloudsmith.com/integrations/integrating-with-jenkins)
    - [MCP](https://docs.cloudsmith.com/integrations/integrating-with-mcp)
    - [Microsoft Teams](https://docs.cloudsmith.com/integrations/integrating-with-microsoft-teams)
    - [MLflow](https://docs.cloudsmith.com/integrations/integrating-with-mlflow)
    - [Octopus Deploy](https://docs.cloudsmith.com/integrations/integrating-with-octopus-deploy)
    - [Puppet](https://docs.cloudsmith.com/integrations/integrating-with-puppet)
    - [Roadie](https://docs.cloudsmith.com/integrations/integrating-with-roadie)
    - [Renovate](https://docs.cloudsmith.com/integrations/integrating-with-renovate)
    - [Semaphore CI](https://docs.cloudsmith.com/integrations/integrating-with-semaphore-ci)
    - [Slack](https://docs.cloudsmith.com/integrations/integrating-with-slack)
    - [Terraform Provider](https://docs.cloudsmith.com/integrations/integrating-with-terraform)
    - [TeamCity](https://docs.cloudsmith.com/integrations/integrating-with-teamcity)
    - [Theia IDE](https://docs.cloudsmith.com/developer-tools/vscode)
    - [Travis CI](https://docs.cloudsmith.com/integrations/integrating-with-travis-ci)
    - [VS Code Extension](https://docs.cloudsmith.com/developer-tools/vscode)
    - [Zapier](https://docs.cloudsmith.com/integrations/integrating-with-zapier)
  - [Developer Tools](https://docs.cloudsmith.com/about-cloudsmith#developer-tools)
    - [Generating an API Key](https://docs.cloudsmith.com/accounts-and-teams/api-key)
    - [Cloudsmith CLI](https://docs.cloudsmith.com/developer-tools/cli)
    - [API Reference](https://docs.cloudsmith.com/api)
    - [VS Code Extension](https://docs.cloudsmith.com/developer-tools/vscode)
    - [API Bindings](https://docs.cloudsmith.com/developer-tools/api-bindings)
    - [Webhooks](https://docs.cloudsmith.com/developer-tools/webhooks)
    - [Terraform Provider](https://docs.cloudsmith.com/developer-tools/terraform-provider)
    - [Developer Community](https://docs.cloudsmith.com/developer-tools/developer-community)
  - [Migrating to Cloudsmith](https://docs.cloudsmith.com/migrating-to-cloudsmith)
    - [Migrating from JFrog Artifactory](https://docs.cloudsmith.com/migrating-to-cloudsmith/export-from-jfrog-artifactory)
    - [Migrating from Nexus Sonatype](https://docs.cloudsmith.com/migrating-to-cloudsmith/export-from-nexus-sonatype)
    - [Exporting NuGet](https://docs.cloudsmith.com/migrating-to-cloudsmith/exporting-nuget)
    - [Import files from a folder](https://docs.cloudsmith.com/migrating-to-cloudsmith/import-files-from-a-folder)
    - [Import Maven](https://docs.cloudsmith.com/migrating-to-cloudsmith/import-maven)
    - [Import npm](https://docs.cloudsmith.com/migrating-to-cloudsmith/import-npm)
    - [Import NuGet](https://docs.cloudsmith.com/migrating-to-cloudsmith/import-nuget)
    - [Import Docker](https://docs.cloudsmith.com/migrating-to-cloudsmith/import-docker)
    - [Import Python](https://docs.cloudsmith.com/migrating-to-cloudsmith/import-python)
    - [Import Debian](https://docs.cloudsmith.com/migrating-to-cloudsmith/import-debian)
    - [Import RPM](https://docs.cloudsmith.com/migrating-to-cloudsmith/import-rpm)
  - [Resources](https://docs.cloudsmith.com/resources)
    - [Bug Bounty Program](https://docs.cloudsmith.com/resources/bug-bounty-program)
    - [Open Source Policy](https://docs.cloudsmith.com/resources/open-source-hosting-policy)
    - [Troubleshooting](https://docs.cloudsmith.com/resources/troubleshooting)

- [Guides](https://docs.cloudsmith.com/guides)
  - [Getting Started](https://docs.cloudsmith.com/guides/getting-started)
  - [Managing Permissions in Cloudsmith](https://docs.cloudsmith.com/guides/managing-permissions)

- [API Reference](https://docs.cloudsmith.com/api)
  - [Introduction](https://docs.cloudsmith.com/api)
  - [Rate Limits](https://docs.cloudsmith.com/api/rate-limits)
  - [Error Handling](https://docs.cloudsmith.com/api/error-handling)

## API Specifications

- [Cloudsmith API v1 (Swagger 2.0)](https://api.cloudsmith.io/swagger/?format=openapi): Machine-readable spec for the v1 API.
- [Cloudsmith API v2 (OpenAPI 3)](https://api.cloudsmith.io/v2/openapi/?format=json): Machine-readable OpenAPI spec for the v2 API.