# Manage Device Firmware Files

Firmware is the built-in software that runs on a desk phone. Storing firmware images in Cloud Voice keeps them ready whenever you update the phones the system provisions (configures automatically). Once a file is in the repository, Cloud Voice offers it as a choice during a firmware update for any matching device model. This page covers adding, editing, and deleting those files.

## Add a firmware file

:::caution
The repository holds a maximum of **5** firmware files, and no single file can be larger than **800 MB**. If 5 files are already stored, delete one before you can add another, and any file over the size limit is rejected.
:::

1. Sign in to the PBX (Private Branch Exchange, your phone system) web portal and open **Auto Provisioning > Resource Repository > Device Firmware**, then click **Add**.
2. Under **Device**, choose the firmware vendor and the device model the file applies to.

   :::caution
   Pick the vendor and model that exactly match the phones you plan to update. A firmware image built for a different model can make a phone unusable when it is later applied, so confirm the model before you upload.
   :::

3. Under **Firmware**, provide the file details:
   - **Firmware Version**: A label for the release so you can recognize it later.
   - **Upload Firmware File**: Click **Browse** and pick the firmware image from your computer.
   - **Remark**: An optional short note describing the file.

   :::tip
   Give the **Firmware Version** field a clear, consistent name, such as the vendor's own version number plus the date you added it. A predictable label makes the right release easy to spot when several are listed.
   :::

4. Click **Save**.

The file now appears in the **Device Firmware** list. From then on, Cloud Voice detects and offers it as an option whenever you update the firmware on a matching phone.

## Edit a firmware file

1. Sign in to the PBX web portal and open **Auto Provisioning > Resource Repository > Device Firmware**.
2. Click ![Edit](/images/pbx/edit.png) next to the file you want to change.
3. Under **Firmware**, adjust the details or swap in a new image:
   - **Firmware Version**: Update the release label.
   - **Upload**: Click **Browse** and select a replacement firmware image.
   - **Remark**: Revise the optional note.
4. Click **Save**.

:::note
Editing the repository entry does not change the firmware already running on any phone. A phone picks up the new image only the next time you run a firmware update on it.
:::

## Delete firmware files

1. Sign in to the PBX web portal and open **Auto Provisioning > Resource Repository > Device Firmware**.
2. Remove one file or several at once:
   - For a single file, click ![Delete](/images/pbx/delete.png) next to it.
   - For multiple files, select their checkboxes and click **Delete**.
3. Click **OK** to confirm.

:::caution
Deleting a file removes it from the repository, so it can no longer be selected during a firmware update. Phones already running that firmware keep working normally. Deleting also frees a slot toward the 5-file limit.
:::