---
title: "Cloudsmith CLI now available as an official Docker image"
description: "The Cloudsmith official Docker image provides a portable, consistent way to run the CLI in automation workflows without managing local installations."
canonical_url: "https://cloudsmith.com/changelog/cloudsmith-cli-now-available-as-an-official-docker-image"
last_updated: "2025-07-16T17:27:56.683Z"
---
# Cloudsmith CLI now available as an official Docker image

You can now run the [Cloudsmith CLI](https://help.cloudsmith.io/docs/cli) anywhere Docker is supported - no installation needed. This makes it easier to integrate into containerized workflows and CI/CD systems, where setup speed and consistency matter.

### Why it matters

Installing and managing the CLI across environments, especially in CI/CD pipelines, often meant extra setup steps or custom scripts. The official Docker image provides a portable, consistent way to run the CLI in automation workflows without managing local installations.

### What’s new

- Official image published on Docker Hub at [cloudsmith/cloudsmith-cli](https://hub.docker.com/r/cloudsmith/cloudsmith-cli)
- Supports all CLI packaging formats and commands
- Designed for use in CI/CD jobs, dev containers, and other container-native environments

### How to use it

- Pull the image:

```json
{
  "_key": "16147cff4b09",
  "_type": "code",
  "code": "docker pull cloudsmith/cloudsmith-cli",
  "filename": null,
  "language": null,
  "markDefs": null
}
```

- Run the CLI with a single command:

```json
{
  "_key": "62da30d0a04b",
  "_type": "code",
  "code": "docker run --rm -e CLOUDSMITH_API_KEY=your-api-key cloudsmith/cloudsmith-cli whoami",
  "filename": null,
  "language": null,
  "markDefs": null
}
```

- Pass credentials as environment variables or mount config files for authenticated commands
- Supports all packaging formats and commands available in the CLI

Need a quick way to use the Cloudsmith CLI in CI/CD or containerized environments? This image is the fastest path forward. It’s available now [on Docker Hub]().