# Install Debian Package

The Install Debian Package step type enables you to install Debian packages onto your edge devices. The step type can be used within an [update flow](https://docs.connect.jfrog.io/features-new-ui/deployments/update-flow) to automate the installation process.

This document describes how to configure an Install Debian Package step type.

## Prerequisites

* At least one device registered with JFrog Connect.
* A local Artifactory repository. Connect does not support remote repositories.
* One or more Debian packages ready for deployment, signed, and stored in your Artifactory repository. To sign the Debian package, see [Sign Debian Metadata](https://jfrog.com/help/r/jfrog-artifactory-documentation/sign-debian-metadata).
* If you are using JFrog as your registry, **Artifactory Project** and **Artifactory Environment** must be set to **All** in the JFrog Registry Scope.
* The repository that you choose must have a signed key. For more information about signing, see [Manage Signing Keys](https://jfrog.com/help/r/jfrog-platform-administration-documentation/manage-signing-keys).
* In the [Create Update Flow](https://docs.connect.jfrog.io/features-new-ui/deployments/update-flow) procedure, completed through Step 3.

## Add a Step and Configure the Step Type <a href="#add-a-step-and-configure-the-step-type" id="add-a-step-and-configure-the-step-type"></a>

To add a step and configure the step type you have chosen, do the following:

1. In the Create New Flow page, click **Add Step**.
2. In the **Step Type** dropdown list, choose **Install Debian Package**, give the step a **Step** **Name**, and create the step. You can change the step name afterwards if you need to.
3. Choose the **JFrog Registry** where your image is stored. If the registry does not appear in the list, go to [Add JFrog Registry](https://docs.connect.jfrog.io/administration-new-ui/general-settings/registry/add-jfrog-registry) to add yours to the list. Then return to this configuration and the added registry will appear in the list.

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p><strong>Tip</strong>: If you want the step to pull content from an Artifactory Edge account, complete the procedure in <a href="https://docs.connect.jfrog.io/administration-new-ui/general-settings/registry/add-jfrog-registry">Add JFrog Registry</a>, and then choose that registry as your JFrog Registry.</p></div>

<div align="left"><figure><img src="https://1679291640-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOX8HIrQ8f257lv49Od1Z%2Fuploads%2F1hwTqwTD0t6tpCIuTH1o%2Finstall-debian-package-nui-01.png?alt=media&#x26;token=097b1efd-93cb-4ab2-988b-3ef490ea029f" alt="" width="563"><figcaption></figcaption></figure></div>

3. **Packages**: Enter the **Name** and **Version** of the package. If you leave Version blank, the latest version of the package will be installed. If you want to install more than one package, click **Add**. Add an additional row for each additional package.
4. Complete the Update Configuration information:
   * **Repository Name**: The name of the Artifactory repository containing the Debian package you want to install. The repository that you choose must have a signed key. For more information about signing, see [Manage Signing Keys](https://jfrog.com/help/r/jfrog-platform-administration-documentation/manage-signing-keys).
   * **Install GPG Package**: If you do not already have the GPG Package installed on your device, mark this checkbox to install it when you run the software deployment.
   * **Distribution**: The appropriate Debian distribution for your target devices (e.g., Debian Buster, Debian Bullseye, Ubuntu Noble, Ubuntu Jammy).
   * **Component**: The component (e.g., main, universe, contrib) from which to install the package. The default value is `main`.
   * **Update Command Options**: The `apt` or `apt-get` command will be run on the device according to the Linux version. You can add options to tailor the update command to your needs.

{% hint style="success" %}
**Tip**: If you need help finding the parameters above in JFrog Platform, see [Get Artifactory Parameters for Debian](https://docs.connect.jfrog.io/features-new-ui/deployments/update-flow/step-types/install-debian-package/get-artifactory-parameters-for-debian)[.](https://docs.connect.jfrog.io/features-new-ui/deployments/update-flow/step-types/download-artifacts/get-artifactory-path)
{% endhint %}

<div align="left"><figure><img src="https://content.gitbook.com/content/OX8HIrQ8f257lv49Od1Z/blobs/7s5HpNZcea9zWowNxvad/install-debian-package-nui-02.png" alt="" width="563"><figcaption></figcaption></figure></div>

## **Install Configuration (Optional)**

1. **Fix Broken**: Switch this on to run the `apt` or `apt-get` command with the `--fix-broken` option. This can be useful for resolving dependency issues during package installation.
2. **Install Command Options**: The `apt` or `apt-get` command will be run on the device according to the Linux version. You can add options to tailor the install command to your needs. The -y option (equivalent to `--yes` or `--assume-yes`) is set automatically. You can use any of the options supported by the apt package installer.

<div align="left"><figure><img src="https://content.gitbook.com/content/OX8HIrQ8f257lv49Od1Z/blobs/54Bl6kGqIZ0jreknbiRH/install-debian-package-nui-03.png" alt="" width="563"><figcaption></figcaption></figure></div>

## Configure On Failure Policy

1. Configure your [On Failure](https://docs.connect.jfrog.io/features-new-ui/deployments/update-flow/on-failure-and-rollback) policy and instructions for rolling back, should a rollback be necessary.&#x20;
2. Save your step configuration.

## What’s Next?

Learn how to configure your [On Failure](https://docs.connect.jfrog.io/features-new-ui/deployments/update-flow/on-failure-and-rollback) policy in the workflow.