---
title: Firmware update
slug: zero/basics/firmware-update
description: Learn how to update your Flipper Zero firmware via the Flipper Mobile App and qFlipper
image: https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/R2dyNVKbFQfIAq2MzsN8h_firmwareupdprev.png
docTags: 
createdAt: 2021-07-26T17:12:00.000Z
---

![](https://api.archbee.com/api/optimize/3GUDYkC5JgUWgo6RW8piO-AX6-GeQuAq3DXGCqjsguo-20241024-174007.png)

We are constantly updating Flipper Zero firmware. We recommend updating your device regularly to get the latest features and improvements. You can update your Flipper Zero via [Flipper Mobile App](docId:_ma1B6hpJf-2zKch5sW98) or [qFlipper](docId\:yP7RVaic3qbnExF1iTA_g).

On this page, you’ll learn how to update your Flipper Zero firmware via Flipper Mobile App and qFlipper.

***

There are three firmware update channels:

- <font color="#ff4500">**DEVELOPMENT (Dev):** </font>We have an ongoing development process. So, a new development version of the firmware is built with every new commit, often multiple times per day. This version includes all the latest features, but it may be unstable, cause freezing or corruption of your data, or fail to function altogether.

- <font color="#8a2be2">**RELEASE-CANDIDATE (RC):** </font>It’s a firmware version that has been submitted for validation testing to our QA department. If any bugs are detected during the testing phase, the version is revised, and a new Release candidate is issued. Once the release candidate successfully passes all tests, it becomes the Release version.****

- <font color="#32cd32">**RELEASE:** </font>The stable version of the firmware. It’s been extensively tested to ensure its reliability, so we recommend it for general use.

***

:::Iframe{iframeHeight="500" code="<div class=&#x22;warning flipper-callout&#x22;>&#xA;    <div class=&#x22;callout-header&#x22;>Insert a microSD card before the update procedure</div>&#xA;    A microSD card must be inserted into your Flipper Zero to update the firmware correctly. Flipper Zero databases are stored on a microSD card. To learn more, see <a href=&#x22;https://docs.flipper.net/zero/basics/sd-card&#x22; onclick=&#x22;next.router.push('https://docs.flipper.net/zero/basics/sd-card')&#x22;><u>MicroSD card setup</u>.&#xA;</div>"}

:::

You can find the changelog for Flipper Zero firmware on the [Releases page](https://github.com/flipperdevices/flipperzero-firmware/releases) of our official GitHub repository.

***

# Updating via Flipper Mobile App

With [Flipper Mobile App](docId:_ma1B6hpJf-2zKch5sW98), you can update your Flipper Zero via Bluetooth. The application is available on iOS and Android:

:::Iframe{code="<style>&#xA;    .app-links {&#xA;        width: 100%;&#xA;        display: flex;&#xA;        flex-wrap: wrap;&#xA;        justify-content: space-evenly;&#xA;    }&#xA;    .app-links > a {&#xA;        margin: 1rem 0;&#xA;        background-repeat: no-repeat;&#xA;        background-size: contain;&#xA;    }&#xA;    .app-links > a:first-of-type {&#xA;        width: 224px;&#xA;        height: 75px;&#xA;        background-image: url(https://cdn.flipperzero.one/App_Store_Badge_svg.svg);&#xA;    }&#xA;    .app-links > a:last-of-type {&#xA;        width: 242px;&#xA;        height: 74px;&#xA;        background-image: url(https://cdn.flipperzero.one/Google_Play_Badge__svg.svg);&#xA;    }&#xA;</style>&#xA;<div class=&#x22;app-links&#x22;>&#xA;    <a href=&#x22;https://apps.apple.com/app/flipper-mobile-app/id1534655259&#x22;></a>&#xA;    <a href=&#x22;https://play.google.com/store/apps/details?id=com.flipperdevices.app&#x22;></a>&#xA;</div>" iframeHeight="0"}

:::

## Connecting to Flipper Zero

After you have downloaded Flipper Mobile App and activated Bluetooth on your phone, connect the mobile application to your Flipper Zero:

::::WorkflowBlock
:::WorkflowBlockItem
Activate Bluetooth on your Flipper Zero by following these steps:

1\) Go to **Main Menu** **-> Settings** **->** **Bluetooth**.

2\) Set **Bluetooth** to **ON**.
:::

:::WorkflowBlockItem
In Flipper Mobile App, tap **Connect**.
:::

:::WorkflowBlockItem
On the next page, next to the detected Flipper Zero’s name, tap **Connect**.

![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/LsRBYaXS9ePraqf57ggL0_image.png "You can connect Flipper Zero to your phone via Bluetooth")
:::

:::WorkflowBlockItem
In Flipper Mobile App, **enter the pairing code** displayed on the Flipper Zero screen.
:::

:::WorkflowBlockItem
Tap **Pair** to finalize pairing.
:::
::::

### If your Flipper Zero is not detected

- Make sure Bluetooth is activated on your Flipper Zero. -> [How to turn on Bluetooth on Flipper Zero](docId\:ze72ryb0eG89CXCLRfHT7).&#x20;

- Check the Bluetooth connection on your phone.

- Disconnect Flipper Zero from other devices. -> [How to forget all paired devices on Flipper Zero](docId\:ze72ryb0eG89CXCLRfHT7).

- Update Flipper Zero to the latest firmware version. It is important to update your Flipper Zero regularly. -> [How to update the firmware on Flipper Zero](docId:_kNT46fphadeqSdq6Sx1d).

- Check if the latest version of Flipper Mobile App is installed on your phone. -> [App Store](https://apps.apple.com/us/app/flipper-mobile-app/id1534655259) or [Google Play](https://play.google.com/store/apps/details?id=com.flipperdevices.app).

- Reboot your Flipper Zero by pressing and holding the %left%**LEFT** and %back%**BACK** buttons for 5 seconds.

## Updating Flipper Zero

To update your Flipper Zero via Flipper Mobile App, do the following:

::::WorkflowBlock
:::WorkflowBlockItem
In the main tab, tap **Update Channel** and select desired firmware **(Release is recommended)**.
:::

:::WorkflowBlockItem
Tap the **Update** button.
:::

:::WorkflowBlockItem
In the dialog window, tap the **Update** button to confirm the action.
:::
::::

The update via Flipper Mobile App may take **around 10 minutes**.

![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/EbcfixQU3o24j8OFEnGWT_flipper-zero-firmware-update-via-mobile-app-1.png "You can update your Flipper Zero via Flipper Mobile App")

### If Flipper Zero update failed

- Check the Bluetooth connection with your Flipper Zero.

- Make sure your Flipper Zero is turned on.

- If your Flipper Zero doesn’t respond, reboot it by pressing and holding the %left%**LEFT** and %back%**BACK** buttons for 5 seconds.

- Restart firmware update.

- Update your Flipper Zero via qFlipper.

***

# Updating via qFlipper

![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/KxR78XKjlPwXWn04J-uLS_monosnap-miro-2023-11-29-16-00-28.jpg "With qFlipper you can update firmware, manage files, and repair corrupted firmware")

[qFlipper](https://docs.flipper.net/zero/qflipper) is a desktop application that allows you to update your Flipper Zero via a USB cable. qFlipper is available on Windows, macOS, and Linux. To install qFlipper on your computer, do the following:

::::::::WorkflowBlock
::::WorkflowBlockItem
Download the qFlipper installation file for your operating system.

:::Iframe{code="<style>&#xA;    .qf-download-btn {&#xA;        display: flex;&#xA;        flex-direction: column;&#xA;        justify-content: center;&#xA;        width: 310px;&#xA;        height: 86px;&#xA;        text-align: center;&#xA;        color: #ffffff;&#xA;        font-size: 22px;&#xA;        line-height: 1.55;&#xA;        border-radius: 10px;&#xA;        background-color: #1faa20;&#xA;        transition: background-color 0.2s ease-in-out, color 0.2s ease-in-out, border-color 0.2s ease-in-out;&#xA;    }&#xA;    .qf-download-btn img {&#xA;        display: inline;&#xA;    }&#xA;</style>&#xA;<div style=&#x22;display: flex; justify-content: center;&#x22;>&#xA;    <a class=&#x22;qf-download-btn&#x22; href=&#x22;current&#x22;><span style=&#x22;font-size: 125%;&#x22;>Download qFlipper</span><span>for macOS</span></a>&#xA;</div>&#xA;<script>&#xA;    (() => {&#xA;      const qFlipper = { version: '', links: { macOS: '', Windows: '', Linux: '' } }&#xA;      let os = 'Windows'&#xA;      if (navigator.userAgent.includes('Macintosh')) { os = 'macOS' } else if (navigator.userAgent.includes('Linux') && !navigator.userAgent.includes('Android')) { os = 'Linux' } else { os = 'Windows' }&#xA;      function findLatest (versions) {&#xA;        let max = 0&#xA;        versions.forEach(e => { if (e.timestamp > max) { max = e.timestamp } })&#xA;        return versions.find(e => e.timestamp === max)&#xA;      }&#xA;      fetch('https://update.flipperzero.one/qFlipper/directory.json').then((response) => { return response.json() }).then(data => {&#xA;        const release = data.channels.find(e => e.id === 'release')&#xA;        let max = 0&#xA;        release.versions.forEach(e => { if (e.timestamp > max) { max = e.timestamp } })&#xA;        const latest = findLatest(release.versions)&#xA;        qFlipper.version = latest.version&#xA;        qFlipper.links.macOS = latest.files.find(e => e.target === 'macos/amd64').url&#xA;        qFlipper.links.Windows = latest.files.find(e => e.target === 'windows/amd64' && e.type === 'installer').url&#xA;        qFlipper.links.Linux = latest.files.find(e => e.target === 'linux/amd64').url&#xA;        document.querySelector('[href=&#x22;current&#x22;]').innerHTML = '<span style=&#x22;font-size: 125%;&#x22;>Download qFlipper</span><span>for <img style=&#x22;position: relative;top: -2px;margin: 0px 2px 0 8px;&#x22; src=&#x22;https://cdn.flipperzero.one/' + os + '-white-logo.svg&#x22;/> ' + os + '</span>'&#xA;        document.querySelector('[href=&#x22;current&#x22;]').setAttribute('href', qFlipper.links[os])&#xA;        document.querySelector('[href=&#x22;macOS&#x22;]').setAttribute('href', qFlipper.links.macOS)&#xA;        document.querySelector('[href=&#x22;Windows&#x22;]').setAttribute('href', qFlipper.links.Windows)&#xA;        document.querySelector('[href=&#x22;Linux&#x22;]').setAttribute('href', qFlipper.links.Linux)&#xA;      })&#xA;      fetch('https://update.flipperzero.one/firmware/directory.json').then((response) => { return response.json() }).then(data => {&#xA;        const dev = data.channels.find(e => e.id === 'development')&#xA;        const rc = data.channels.find(e => e.id === 'release-candidate')&#xA;        const release = data.channels.find(e => e.id === 'release')&#xA;        let latest = findLatest(dev.versions)&#xA;        document.querySelector('[href=&#x22;dev&#x22;]').innerHTML = 'Dev Unstable   <span style=&#x22;color: rgb(253, 36, 36);&#x22;>' + latest.version + '</span>'&#xA;        document.querySelector('[href=&#x22;dev&#x22;]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)&#xA;        latest = findLatest(rc.versions)&#xA;        document.querySelector('[href=&#x22;rc&#x22;]').innerHTML = 'Release Candidate   <span style=&#x22;color: rgb(135, 42, 204);&#x22;>' + latest.version + '</span>'&#xA;        document.querySelector('[href=&#x22;rc&#x22;]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)&#xA;        latest = findLatest(release.versions)&#xA;        document.querySelector('[href=&#x22;release&#x22;]').innerHTML = 'Latest Release   <span style=&#x22;color: rgb(59, 207, 70);&#x22;>' + latest.version + '</span>'&#xA;        document.querySelector('[href=&#x22;release&#x22;]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)&#xA;      })&#xA;    })()&#xA;</script>" iframeHeight="0"}

:::

You can also download qFlipper on the [Flipper Zero Firmware update](https://flipperzero.one/update) page.
::::

:::::::WorkflowBlockItem
Run the downloaded file and follow the instructions for your operating system.

::::::Tabs
:::Tab{title="%windows%Windows"}
For Windows, qFlipper is compatible with **Windows 10 and 11 only**.



::Image[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/XY9MzEKeRmDnvePKkIYoL_image-3.png" size="72" width="996" height="744" caption="qFlipper is available on Windows" position="center" showCaption="true"}


:::

:::Tab{title="%mac%macOS"}
qFlipper is compatible with **macOS version 10.14 or later**. The application is **optimized for M1 Apple Silicon Macs**.

::Image[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/95k0UR1DiBdZ1PgkHCIhJ_image.png" size="78" width="1424" height="1024" caption="qFlipper is available on macOS" position="center" showCaption="true"}


:::

:::::Tab{title="%linux%Linux "}
For Linux, qFlipper is downloaded in the **AppImage format**. Before running qFlipper on Linux, you need to make it executable:

**Using the GUI**

::::WorkflowBlock
:::WorkflowBlockItem
In the file manager, right-click the downloaded file.
:::

:::WorkflowBlockItem
Go to **Properties -> Permissions**.
:::

:::WorkflowBlockItem
Click the **Allow executing file as program** checkbox if you are using a Nautilus-based file manager (Files, Nemo, Caja), or click the **Is executable&#x20;**&#x63;heckbox if you are using Dolphin, or change the  **Execute** drop-down list to **Anyone** if you are using PCManFM.
:::

:::WorkflowBlockItem
Close the dialog.
:::

:::WorkflowBlockItem
Double-click on the AppImage file to run.
:::
::::



**Using the Terminal**

::::WorkflowBlock
:::WorkflowBlockItem
Open the Terminal.
:::

:::WorkflowBlockItem
Change to the directory containing the AppImage file.
:::

:::WorkflowBlockItem
Make the AppImage executable: `chmod +x filename.AppImage`.
:::

:::WorkflowBlockItem
Run the AppImage: `./filename.AppImage`.
:::
::::



**Set up udev rules**

After making the application executable via the GUI or Terminal, you’ll need to set up udev rules in order to use qFlipper as a normal user:

`./qFlipper-x86_64.AppImage rules install [/optional/path/to/rules/dir]`
:::::
::::::
:::::::
::::::::

## Updating Flipper Zero

To update your Flipper Zero via qFlipper, do the following:

::::WorkflowBlock
:::WorkflowBlockItem
Connect your Flipper Zero to your computer via a USB cable.
:::

:::WorkflowBlockItem
On your computer, run **qFlipper**.
:::

:::WorkflowBlockItem
In qFlipper, go to the **Advanced controls** tab.
:::

:::WorkflowBlockItem
Click **Update Channel** and select a firmware version from the drop-down list (**Release is recommended**).
:::

:::WorkflowBlockItem
Click **Update** to start the update process.

![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/OoPv0A8kmd2iajMXrW_aS_monosnap-miro-2023-11-29-16-01-36.jpg "Update your Flipper Zero via qFlipper")
:::
::::

***

Having trouble updating the firmware of your Flipper Zero? Check out the following pages:

::::LinkArray{contentSource="CUSTOM"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/2m7XpdT1ka8fl7vLZwEfM_monosnap-miro-2023-08-07-19-56-04.jpg"}
[Internal storage repair](docId\:OSrvqhe-awCw2P8RWEN9A)
:::

:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/jaiIg8e0P0yP7ErCmJhv4_monosnap-miro-2023-08-07-19-56-23.jpg"}
[Firmware recovery](docId\:iap4a8jl_afGcpQf8K38h)
:::
::::