> 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/new-to-artifact-registry/quickstart/debian-quickstart.md). # Debian {% @harness-package-selector/package-selector platforms="%5B%7B%22label%22%3A%22Docker%22%2C%22slug%22%3A%22docker%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fdocker-quickstart%22%7D%2C%7B%22label%22%3A%22Helm%22%2C%22slug%22%3A%22helm%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fhelm-quickstart%22%7D%2C%7B%22label%22%3A%22Helm%20HTTP%22%2C%22slug%22%3A%22helm-http%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fhelm-http-quickstart%22%7D%2C%7B%22label%22%3A%22Generic%22%2C%22slug%22%3A%22generic%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fgeneric-quickstart%22%7D%2C%7B%22label%22%3A%22Raw%20File%22%2C%22slug%22%3A%22raw-file%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fraw-file-quickstart%22%7D%2C%7B%22label%22%3A%22Maven%22%2C%22slug%22%3A%22maven%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fmaven-quickstart%22%7D%2C%7B%22label%22%3A%22Python%22%2C%22slug%22%3A%22python%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fpython-quickstart%22%7D%2C%7B%22label%22%3A%22NPM%22%2C%22slug%22%3A%22npm%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fnpm-quickstart%22%7D%2C%7B%22label%22%3A%22Nuget%22%2C%22slug%22%3A%22nuget%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fnuget-quickstart%22%7D%2C%7B%22label%22%3A%22RPM%22%2C%22slug%22%3A%22rpm%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Frpm-quickstart%22%7D%2C%7B%22label%22%3A%22Debian%22%2C%22slug%22%3A%22debian%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fdebian-quickstart%22%7D%2C%7B%22label%22%3A%22Alpine%22%2C%22slug%22%3A%22alpine%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Falpine-quickstart%22%7D%2C%7B%22label%22%3A%22Wolfi%22%2C%22slug%22%3A%22wolfi%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fwolfi-quickstart%22%7D%2C%7B%22label%22%3A%22Cargo%22%2C%22slug%22%3A%22cargo%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fcargo-quickstart%22%7D%2C%7B%22label%22%3A%22Conan%22%2C%22slug%22%3A%22conan%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fconan-quickstart%22%7D%2C%7B%22label%22%3A%22Go%22%2C%22slug%22%3A%22go%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fgo-quickstart%22%7D%2C%7B%22label%22%3A%22Hugging%20Face%22%2C%22slug%22%3A%22hugging-face%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fhugging-face-quickstart%22%7D%2C%7B%22label%22%3A%22Conda%22%2C%22slug%22%3A%22conda%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fconda-quickstart%22%7D%2C%7B%22label%22%3A%22Dart%22%2C%22slug%22%3A%22dart%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fdart-quickstart%22%7D%2C%7B%22label%22%3A%22PHP%20Composer%22%2C%22slug%22%3A%22php-composer%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fphp-composer-quickstart%22%7D%2C%7B%22label%22%3A%22Swift%22%2C%22slug%22%3A%22swift%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fswift-quickstart%22%7D%2C%7B%22label%22%3A%22Puppet%22%2C%22slug%22%3A%22puppet%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fpuppet-quickstart%22%7D%2C%7B%22label%22%3A%22Terraform%22%2C%22slug%22%3A%22terraform%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fterraform-quickstart%22%7D%2C%7B%22label%22%3A%22R%20(CRAN)%22%2C%22slug%22%3A%22r-cran%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Fr-cran-quickstart%22%7D%2C%7B%22label%22%3A%22RubyGems%22%2C%22slug%22%3A%22rubygems%22%2C%22path%22%3A%22artifact-registry%2Fnew-to-artifact-registry%2Fquickstart%2Frubygems-quickstart%22%7D%5D" selectedPlatform="debian" %} Use a **Debian** registry to host, proxy, and distribute `.deb` packages compatible with Debian and Ubuntu systems. Harness Artifact Registry supports APT-based package installation, source uploads, and upstream proxying from external Debian repositories. *** ### Before you begin * **APT package manager:** Available on any Debian or Ubuntu system by default. * **Harness permissions:** Registry-create access in the target project. Go to [RBAC in Harness](/harness-ai/use-harness-platform/platform-access-control.md) to configure roles. *** ### Create a Debian Artifact Registry {% tabs %} {% tab title="Interactive Guide" %} {% embed url="" %} {% endtab %} {% tab title="Step-by-Step" %} 1. Go to the Artifact Registry module in your Harness project. 2. Select **New Artifact Registry**. 3. In the Registry Type list, select **Debian**. 4. Provide a Registry Name.

REGISTRY NAME REQUIREMENTS

This registry name must start with a letter and can only contain lowercase alphanumerics, _, . and -, and must be unique to your Harness Account.

5. Optionally, add a Description and Labels for better organization. 6. In the **Debian Config** section, set **Indexed Remote Architectures**. The default values are `amd64`, `i386`, and `arm64`. Select from these defaults or add any additional architectures that need to be indexed from remote repositories.

INDEXED REMOTE ARCHITECTURES

Indexed Remote Architectures lists the architectures Harness indexes from remote repositories on this registry.

If you leave the field empty, Harness caches all available architectures that results in increased cold-start index generation time and costs.

If you select values (amd64, i386, arm64) or enter a custom architecture name, Harness indexes only those architectures.

7. Harness generates a `.gz` index by default. In **Optional Index Compression Formats**, you can also select **XZ (.xz extension)**, that increases the cold-start index generation time and cost. 8. Choose visibility between **Public** and **Private**. 9. Select **Create Registry** to finalize. {% endtab %} {% endtabs %} {% hint style="info" %} **PRIVATE DEBIAN REGISTRY** This registry will serve as your private Debian registry within Harness. {% endhint %} *** #### Edit Debian configuration **Debian Config** appears on the registry **Configuration** tab, after Artifact Registry Definition (name, description, and labels). 1. Open the Debian artifact registry. 2. Select the **Configuration** tab. 3. In the **Debian Config**, update **Indexed Remote Architectures**. 4. Optionally, specify the **Optional Index Compression Formats**. 5. Click **Save**. *** ### Configure an upstream proxy (optional) An upstream proxy allows your registry to fetch Debian packages from external repositories (such as official Debian or Ubuntu mirrors) if they are not available locally. {% tabs %} {% tab title="Interactive Guide" %} #### Create the upstream proxy {% embed url="" %} #### Configure the upstream proxy in your registry {% embed url="" %} {% endtab %} {% tab title="Step-by-Step" %} #### Create an upstream proxy 1. In the Artifact Registry module, select the dropdown next to **New Artifact Registry** and select **Upstream Proxy**. 2. Choose **Debian Registry** as the proxy type. 3. Enter an upstream proxy name. 4. Enter your remote repository URL. The URL must point to the **parent directory** of the `/dists` folder for that repository (for example, `http://deb.debian.org/debian`, where `http://deb.debian.org/debian/dists/` contains the release metadata). If you use another Debian mirror or private repository, verify the path ends at that parent level, not at a distribution or component subdirectory. 5. Choose your Authentication method (`Anonymous` by default). 6. Select **Create Proxy** to establish the connection. #### Configure the upstream proxy in your registry 1. In the Artifact Registry module, select an existing Artifact Registry. 2. Select the **Configuration** tab. 3. Under **Advanced (Optional)**, select **Configure Upstream**. 4. Select from the list of compatible proxies to add them to your registry. 5. Select **Save** to save the configuration. {% endtab %} {% endtabs %} {% hint style="info" %} **UPSTREAM PROXY BEHAVIOR** When you install a package through the upstream proxy, it fetches the package from the configured external repository and caches it locally. Subsequent installs for the same package version are served from the local cache. {% endhint %} {% hint style="info" %} **DEBIAN REGISTRY METADATA** Harness regenerates Debian registry metadata when you upload or delete an artifact, or when you add or remove an upstream proxy from a registry. This operation can take a couple of minutes, so your changes might not appear in APT metadata immediately. {% endhint %} *** ### Set up the client With your Debian registry created, you can now configure APT to install packages from your Harness registry. #### 1. Configure authentication In your Harness Debian Artifact Registry, select **Setup Client** and then **Generate Token** to generate an identity token for authentication. #### 2. Add the repository to APT sources ```bash echo "deb [trusted=yes] https://pkg.harness.io/pkg///debian " | sudo tee /etc/apt/sources.list.d/harness.list ``` #### 3. Configure authentication for APT Create or edit the auth config file: ```bash sudo vi /etc/apt/auth.conf.d/harness-.conf ``` Add the following content: ``` machine pkg.harness.io login password ``` #### 4. Update APT cache ```bash sudo apt-get update ``` #### 5. Install a package ```bash sudo apt-get install = ``` #### 6. Upload a .deb package ```bash curl --location --request PUT 'https://pkg.harness.io/pkg///debian/deb?distribution=&component=' \ --form 'file=@""' \ --header 'x-api-key: ' ``` #### 7. Upload Debian sources (optional) Upload a `.dsc` file: ```bash curl --location --request PUT 'https://pkg.harness.io/pkg///debian/dsc?distribution=&component=' \ --form 'file=@""' \ --header 'x-api-key: ' ``` Upload a source tarball (for upstream source tarballs, specify the upstream version): ```bash curl --location --request PUT 'https://pkg.harness.io/pkg///debian/src?distribution=&component=&package=&version=' \ --form 'file=@""' \ --header 'x-api-key: ' ```