> ## Documentation Index
> Fetch the complete documentation index at: https://bytebeam.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Deb Update

> Learn how to install deb packages using deb_update on your device with this comprehensive guide. Follow a step-by-step example on Github that includes all necessary files. Replace the apt-src deb package, generate the update tar file with make_firmware_update.sh

If you have a deb package to be installed on the device, then deb\_update is the right way to do it.  The example on [Github](https://github.com/bytebeamio/uplink/tree/main/examples/rpi/updates/deb_update) page shows how to install a deb package on the device. There are four files mentioned in the example.

* **deb\_update.sh** - It installs the specified deb package on the device.
* **apt-src\_0.25.3\_all.deb** - In the example, we try to install this deb package.
* **update.sh** - This is the wrapper script for deb\_update.sh
* **make\_firmware\_update.sh** - This creates the update tar file, that needs to be uploaded on the Bytebeam cloud.

## Step1: Prepare update tar

Firstly on your Linux system, we need to create an update tar file for Raspberry Pi. For that, Download all the files mentioned above from GitHub. Next, we need to change the permissions for all these files using `chmod` command

```shell theme={null}
chmod a+x apt-src_0.25.3_all.deb
chmod a+x deb_update.sh
chmod a+x update.sh
chmod a+x make_firmware_update.sh 
```

Next, run **make\_firmware\_update.sh** to create a tar.gz file.

```shell theme={null}
./make_firmware_update.sh
```

## Step 2: upload update Tar

Next, we need to upload the tar to [bytebeam cloud.](https://cloud.bytebeam.io/) For that go to the device management panel and navigate to the **Firmware Versions** tab. Then click on **Upload New Firmware**

<img src="https://mintcdn.com/bytebeamio/ftUl6Tv5QMaNi0Gs/assets/umzb2gK2AoDe3mek5n9Nm_linuxdocsupdaterollback2.png?fit=max&auto=format&n=ftUl6Tv5QMaNi0Gs&q=85&s=f91f886ed7c04488bc78ff84c52310fd" alt="" width="1641" height="520" data-path="assets/umzb2gK2AoDe3mek5n9Nm_linuxdocsupdaterollback2.png" />

Under the Firmware version tab, you will find an option to create a firmware version number and upload your updated tar file.

Enter the new **Firmware version number** and click on **choose file** to upload tar file. Then click on **Create.**&#x20;

<img src="https://mintcdn.com/bytebeamio/cbGbxWM_WJ5eoYoh/assets/-qOTBnqns0cV7fu-U6Xk0_linuxdocsdebupdatewhite1.png?fit=max&auto=format&n=cbGbxWM_WJ5eoYoh&q=85&s=432484b7a124e42ceeccc076c8d29b46" alt="" width="954" height="588" data-path="assets/-qOTBnqns0cV7fu-U6Xk0_linuxdocsdebupdatewhite1.png" />

## Step 3: Trigger the "update firmware" action from bytebeam cloud&#x20;

Now let's proceed with our OTA update. For that, Go to **the Device Management** panel and select the device

Next, Click on the **update firmware**

<img src="https://mintcdn.com/bytebeamio/ftUl6Tv5QMaNi0Gs/assets/sYIB2c26EWzgHU--LZoyf_linuxdocsupdate12.png?fit=max&auto=format&n=ftUl6Tv5QMaNi0Gs&q=85&s=c1b80481c32bdb7db0824547d3eafcfa" alt="" width="1191" height="542" data-path="assets/sYIB2c26EWzgHU--LZoyf_linuxdocsupdate12.png" />

In the next prompt choose the **firmware version** and click on **next**

<img src="https://mintcdn.com/bytebeamio/K35qLcH5nuNVBNLm/assets/JZecBPwI4TD63RSPlDsy9_linuxdocsupdatewhite4.png?fit=max&auto=format&n=K35qLcH5nuNVBNLm&q=85&s=c449c9dc8f40861d057176772a8ae96b" alt="" width="722" height="345" data-path="assets/JZecBPwI4TD63RSPlDsy9_linuxdocsupdatewhite4.png" />

<img src="https://mintcdn.com/bytebeamio/YngavNvE_o5FlNvW/assets/yvnrbLYiKMTYecMtL3dy6_linuxdocsupdatewhite5.png?fit=max&auto=format&n=YngavNvE_o5FlNvW&q=85&s=369aff984c953a28a60f6ab23e007576" alt="" width="742" height="544" data-path="assets/yvnrbLYiKMTYecMtL3dy6_linuxdocsupdatewhite5.png" />
