> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/artifact-registry/3.0/get-started/supported-formats.md).

# Supported formats

Every artifact format supported by Harness Artifacts, the client tools and protocol each format uses, and links to client setup guides.

Harness Artifacts supports 26 artifact formats spanning every major programming language, package ecosystem, Linux distribution, and infrastructure toolchain. Whether your team builds containers, publishes Python libraries, ships Debian packages, or manages Terraform modules, you can store, proxy, and govern every artifact type in one place under the same RBAC, lifecycle rules, and Dependency Firewall policies.

Every format supports upstream proxies: you can create an upstream proxy registry for any format and proxy artifacts through it. Dependency Firewall evaluates packages for a subset of non-OCI formats. Alpine, Wolfi, CRAN, APM, Dart, Conda, Swift, and Terraform formats do not generate violations even with an upstream proxy. OCI-based registries (Docker and Helm OCI) do not generate violations; Helm HTTP does.

## Formats by ecosystem

### Containers and Kubernetes

| Format        | What it stores                                                                                                       | Client tools                                     | Setup guide                                                                        |
| ------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------- |
| **Docker**    | Container images (OCI-compatible). Supports multi-arch manifests, image layers, and SBOM and vulnerability scanning. | `docker`, `podman`, `buildah`, `crane`, `skopeo` | [Docker](https://developer.harness.io/artifact-registry/3.0/setup/docker.md)       |
| **Helm OCI**  | Helm charts packaged as OCI artifacts and pushed to an OCI-compatible registry.                                      | `helm` (with `oci://` prefix)                    | [Helm OCI](https://developer.harness.io/artifact-registry/3.0/setup/helm-oci.md)   |
| **Helm HTTP** | Helm charts served over an HTTP chart repository (classic `helm repo add` + `helm pull` workflow).                   | `helm`                                           | [Helm HTTP](https://developer.harness.io/artifact-registry/3.0/setup/helm-http.md) |

### Java Virtual Machine (JVM) ecosystems

| Format    | What it stores                                                                                                     | Client tools                  | Setup guide                                                                |
| --------- | ------------------------------------------------------------------------------------------------------------------ | ----------------------------- | -------------------------------------------------------------------------- |
| **Maven** | Maven artifacts: JARs, WARs, POMs, source JARs, and checksums. Compatible with any Maven HTTP repository consumer. | `mvn`, `gradle`, `sbt`, `ivy` | [Maven](https://developer.harness.io/artifact-registry/3.0/setup/maven.md) |

### JavaScript and TypeScript

| Format  | What it stores                                                                                                             | Client tools          | Setup guide                                                            |
| ------- | -------------------------------------------------------------------------------------------------------------------------- | --------------------- | ---------------------------------------------------------------------- |
| **npm** | Node.js packages (CommonJS and ESM), including scoped packages (`@scope/name`). Compatible with the npm registry protocol. | `npm`, `yarn`, `pnpm` | [npm](https://developer.harness.io/artifact-registry/3.0/setup/npm.md) |

### Python and data science

| Format            | What it stores                                                                                               | Client tools                   | Setup guide                                                                              |
| ----------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------ | ---------------------------------------------------------------------------------------- |
| **Python / PyPI** | Python packages (wheels, sdists) using the PyPI Simple API (PEP 503 and PEP 691).                            | `pip`, `poetry`, `uv`, `twine` | [Python / PyPI](https://developer.harness.io/artifact-registry/3.0/setup/python-pypi.md) |
| **Conda**         | Python and R packages in Conda-compatible repository format. Works with Anaconda and Miniconda environments. | `conda`, `mamba`               | [Conda](https://developer.harness.io/artifact-registry/3.0/setup/conda.md)               |
| **Hugging Face**  | Machine learning models, datasets, and Spaces artifacts in Hugging Face Hub format.                          | `huggingface-cli`, `git lfs`   | [Hugging Face](https://developer.harness.io/artifact-registry/3.0/setup/hugging-face.md) |

### Systems and native languages

| Format         | What it stores                                                                                        | Client tools                       | Setup guide                                                                          |
| -------------- | ----------------------------------------------------------------------------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------ |
| **Cargo**      | Rust crates published to a sparse registry index (RFC 3313).                                          | `cargo`                            | [Cargo](https://developer.harness.io/artifact-registry/3.0/setup/cargo.md)           |
| **Go modules** | Go modules served over the GOPROXY protocol. Supports direct module download and version enumeration. | `go` (using the `GOPROXY` env var) | [Go modules](https://developer.harness.io/artifact-registry/3.0/setup/go-modules.md) |
| **Conan**      | C and C++ packages in Conan v2 format. Supports recipes, binary packages, and revision tracking.      | `conan`                            | [Conan](https://developer.harness.io/artifact-registry/3.0/setup/conan.md)           |
| **Swift**      | Swift packages for the Swift Package Manager (SwiftPM) registry protocol (SE-0291).                   | `swift package`                    | [Swift](https://developer.harness.io/artifact-registry/3.0/setup/swift.md)           |

### Windows and .NET

| Format    | What it stores                                                                               | Client tools               | Setup guide                                                                |
| --------- | -------------------------------------------------------------------------------------------- | -------------------------- | -------------------------------------------------------------------------- |
| **NuGet** | .NET packages in NuGet v3 HTTP API format. Supports packages, symbols, and `dotnet` tooling. | `dotnet`, `nuget`, `paket` | [NuGet](https://developer.harness.io/artifact-registry/3.0/setup/nuget.md) |

### Linux packages

| Format           | What it stores                                                                                 | Client tools             | Setup guide                                                                            |
| ---------------- | ---------------------------------------------------------------------------------------------- | ------------------------ | -------------------------------------------------------------------------------------- |
| **Debian / APT** | Debian and Ubuntu `.deb` packages with a full APT repository layout (`dists/`, `pool/`).       | `apt`, `apt-get`, `dpkg` | [Debian / APT](https://developer.harness.io/artifact-registry/3.0/setup/debian-apt.md) |
| **Alpine / APK** | Alpine Linux packages in APK repository format.                                                | `apk`                    | [Alpine / APK](https://developer.harness.io/artifact-registry/3.0/setup/alpine-apk.md) |
| **Wolfi / APK**  | Wolfi Linux packages in APK repository format, for container builds with `apko` and `melange`. | `apk`, `apko`            | [Wolfi / APK](https://developer.harness.io/artifact-registry/3.0/setup/wolfi-apk.md)   |
| **RPM**          | RPM packages served as a DNF/YUM-compatible repository.                                        | `dnf`, `yum`, `rpm`      | [RPM](https://developer.harness.io/artifact-registry/3.0/setup/rpm.md)                 |

### Web and scripting

| Format              | What it stores                                                                                    | Client tools                        | Setup guide                                                                              |
| ------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------- |
| **PHP Composer**    | PHP packages in Packagist-compatible JSON format.                                                 | `composer`                          | [PHP Composer](https://developer.harness.io/artifact-registry/3.0/setup/php-composer.md) |
| **Ruby / RubyGems** | Ruby gems with RubyGems API and Bundler-compatible source configuration.                          | `gem`, `bundle`                     | [Ruby / RubyGems](https://developer.harness.io/artifact-registry/3.0/setup/ruby-gems.md) |
| **R / CRAN**        | R packages with CRAN-compatible repository layout. Supports both `install.packages()` and `renv`. | `install.packages()`, `renv`, `pak` | [R / CRAN](https://developer.harness.io/artifact-registry/3.0/setup/r-cran.md)           |
| **Dart**            | Dart and Flutter packages using the pub.dev API protocol.                                         | `dart pub`, `flutter pub`           | [Dart](https://developer.harness.io/artifact-registry/3.0/setup/dart.md)                 |

### Infrastructure as code

| Format                | What it stores                                                                       | Client tools                      | Setup guide                                                                                        |
| --------------------- | ------------------------------------------------------------------------------------ | --------------------------------- | -------------------------------------------------------------------------------------------------- |
| **Terraform**         | Terraform modules and providers using the Terraform module registry protocol.        | `terraform`                       | [Terraform](https://developer.harness.io/artifact-registry/3.0/setup/terraform.md)                 |
| **Terraform Backend** | Terraform state files stored and locked through the Terraform HTTP backend protocol. | `terraform` (HTTP backend config) | [Terraform Backend](https://developer.harness.io/artifact-registry/3.0/setup/terraform-backend.md) |

### General purpose

| Format      | What it stores                                                                                                                     | Client tools                                | Setup guide                                                                    |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------ |
| **Generic** | Arbitrary files of any type uploaded and downloaded over HTTP. No packaging format required: any file, any extension, up to 5 TiB. | `curl`, `wget`, any HTTP client             | [Generic](https://developer.harness.io/artifact-registry/3.0/setup/generic.md) |
| **Raw**     | Raw files of any type, uploaded and downloaded by path over HTTP.                                                                  | `curl`, `wget`, any HTTP client             | [Raw](https://developer.harness.io/artifact-registry/3.0/setup/raw.md)         |
| **Puppet**  | Puppet modules in Puppet Forge API v3 format, compatible with `r10k` and `puppet module` workflows.                                | `puppet module`, `r10k`, `librarian-puppet` | [Puppet](https://developer.harness.io/artifact-registry/3.0/setup/puppet.md)   |

***

## Feature support matrix

Every format in this section supports push, pull, and upstream proxy registries. The following table lists the protocol each format uses, for formats where the client tools do not make it obvious.

| Format            | Protocol                            |
| ----------------- | ----------------------------------- |
| Docker            | OCI                                 |
| Helm OCI          | OCI                                 |
| Helm HTTP         | Helm chart repository (HTTP)        |
| Maven             | Maven HTTP repository API           |
| npm               | npm registry protocol               |
| Python / PyPI     | PyPI Simple API (PEP 503 / PEP 691) |
| Conda             | Conda repository format             |
| Hugging Face      | Hugging Face Hub protocol           |
| Cargo             | Sparse registry index (RFC 3313)    |
| Go modules        | GOPROXY protocol                    |
| Conan             | Conan v2 protocol                   |
| Swift             | SwiftPM registry protocol (SE-0291) |
| NuGet             | NuGet v3 HTTP API                   |
| Debian / APT      | APT repository layout               |
| Alpine / APK      | APK repository format               |
| Wolfi / APK       | APK repository format               |
| RPM               | DNF/YUM-compatible repository       |
| PHP Composer      | Packagist-compatible JSON           |
| Ruby / RubyGems   | RubyGems API                        |
| R / CRAN          | CRAN-compatible repository          |
| Dart              | pub.dev API protocol                |
| Terraform         | Terraform module registry protocol  |
| Terraform Backend | Terraform HTTP backend protocol     |
| Generic           | HTTP, no packaging format           |
| Raw               | HTTP, no packaging format           |
| Puppet            | Puppet Forge API v3                 |

{% hint style="info" %}
This table does not include a virtual registry column. Virtual registries are a legacy registry kind from earlier Artifact Registry versions and are no longer created in the Harness Artifacts (New Experience) UI. A prioritized list of upstream proxies attached to a local registry replaces that capability. Go to [Glossary](https://developer.harness.io/artifact-registry/3.0/concepts/glossary.md#virtual-registry-legacy) for details.
{% endhint %}

***

## What is supported per format

### Security scanning

SBOM generation and vulnerability scanning (Aqua Trivy or Grype) apply to **Docker and Helm OCI registries only**. Scan results appear on the **Vulnerabilities** and **SBOM** tabs of the artifact detail page. Go to [Security scanning](https://developer.harness.io/artifact-registry/3.0/concepts/security-scanning.md) for how scanning works.

### Upstream proxies

Every format supports upstream proxy registries. An upstream proxy caches artifacts from an external source (Docker Hub, AWS ECR, a custom URL, or a public package index) in your Harness registry. When Dependency Firewall is enabled on the proxy, inbound packages are evaluated against your security policies before they are cached. Go to [Create an upstream proxy](https://developer.harness.io/artifact-registry/3.0/registries/create-an-upstream-proxy.md) to set one up.

### Lifecycle rules

Cleanup and retention rules apply to **all formats**. You can target specific registries, package types, and version patterns. Go to [Lifecycle Management](https://developer.harness.io/artifact-registry/3.0/lifecycle-management/overview.md) for how to create rules.

### RBAC

RBAC applies at the **registry level** for all formats. You cannot grant access to a single package or version within a registry. The three built-in roles are:

| Role                              | What it allows                                                                           |
| --------------------------------- | ---------------------------------------------------------------------------------------- |
| **Artifact Registry Viewer**      | View registries and browse artifact contents.                                            |
| **Artifact Registry Contributor** | Pull from and push to registries, in addition to Viewer permissions.                     |
| **Artifact Registry Admin**       | Full access: create, configure, and delete registries. Includes Contributor permissions. |

Go to [RBAC and permissions](https://developer.harness.io/artifact-registry/3.0/reference/rbac-and-permissions.md) for the complete permission reference.

***

## Next steps

* To push your first artifact, go to [Quickstart: push your first artifact](https://developer.harness.io/artifact-registry/3.0/get-started/quickstart.md).
* To configure a client for your format, go to the relevant setup guide in [Supported formats](#supported-formats).
* To proxy an external registry, go to [Create an upstream proxy](https://developer.harness.io/artifact-registry/3.0/registries/create-an-upstream-proxy.md).
* To understand how security scanning works for container formats, go to [Security scanning](https://developer.harness.io/artifact-registry/3.0/concepts/security-scanning.md).

{% @harness-feedback/feedback %}
