Basics

Firmware update

﻿
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 or qFlipper.
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:
﻿DEVELOPMENT (Dev): 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.

﻿RELEASE-CANDIDATE (RC): 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.

﻿RELEASE: The stable version of the firmware. It’s been extensively tested to ensure its reliability, so we recommend it for general use.
﻿
<div class="warning flipper-callout">
    <div class="callout-header">Insert a microSD card before the update procedure</div>
    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="https://docs.flipperzero.one/basics/sd-card" onclick="next.router.push('https://docs.flipperzero.one/basics/sd-card')"><u>MicroSD card setup</u>.
</div>
<div class="warning flipper-callout">
    <div class="callout-header">Insert a microSD card before the update procedure</div>
    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="https://docs.flipperzero.one/basics/sd-card" onclick="next.router.push('https://docs.flipperzero.one/basics/sd-card')"><u>MicroSD card setup</u>.
</div>
﻿
You can find the changelog for Flipper Zero firmware on the Releases page of our official GitHub repository.
﻿
Updating via Flipper Mobile App
With Flipper Mobile App, you can update your Flipper Zero via Bluetooth. The application is available on iOS and Android:
<style>
    .app-links {
        width: 100%;
        display: flex;
        flex-wrap: wrap;
        justify-content: space-evenly;
    }
    .app-links > a {
        margin: 1rem 0;
        background-repeat: no-repeat;
        background-size: contain;
    }
    .app-links > a:first-of-type {
        width: 224px;
        height: 75px;
        background-image: url(https://cdn.flipperzero.one/App_Store_Badge_svg.svg);
    }
    .app-links > a:last-of-type {
        width: 242px;
        height: 74px;
        background-image: url(https://cdn.flipperzero.one/Google_Play_Badge__svg.svg);
    }
</style>
<div class="app-links">
    <a href="https://apps.apple.com/app/flipper-mobile-app/id1534655259"></a>
    <a href="https://play.google.com/store/apps/details?id=com.flipperdevices.app"></a>
</div>
<style>
    .app-links {
        width: 100%;
        display: flex;
        flex-wrap: wrap;
        justify-content: space-evenly;
    }
    .app-links > a {
        margin: 1rem 0;
        background-repeat: no-repeat;
        background-size: contain;
    }
    .app-links > a:first-of-type {
        width: 224px;
        height: 75px;
        background-image: url(https://cdn.flipperzero.one/App_Store_Badge_svg.svg);
    }
    .app-links > a:last-of-type {
        width: 242px;
        height: 74px;
        background-image: url(https://cdn.flipperzero.one/Google_Play_Badge__svg.svg);
    }
</style>
<div class="app-links">
    <a href="https://apps.apple.com/app/flipper-mobile-app/id1534655259"></a>
    <a href="https://play.google.com/store/apps/details?id=com.flipperdevices.app"></a>
</div>
﻿
Connecting to Flipper Zero
After you downloaded Flipper Mobile App and activated Bluetooth on your phone, connect the mobile application to your Flipper Zero:
1
Activate Bluetooth on your Flipper Zero by following these steps:
1) Go to Main Menu -> Settings -> Bluetooth.
2) Set Bluetooth to ON.
2
In Flipper Mobile App, tap Connect.
3
On the next page, next to the detected Flipper Zero’s name, tap Connect.
You can connect Flipper Zero to your phone via Bluetooth
﻿
4
In Flipper Mobile App, enter the pairing code displayed on the Flipper Zero screen.
5
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. 

Check the Bluetooth connection on your phone.

Disconnect Flipper Zero from other devices. -> How to forget all paired devices on Flipper Zero.

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.

Check if the latest version of Flipper Mobile App is installed on your phone. -> App Store or Google Play.

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:
1
In the main tab, tap Update Channel and select desired firmware (Release is recommended).
2
Tap the Update button.
3
In the dialog window, tap the Update button to confirm the action.
The update via Flipper Mobile App may take up to around 10 minutes.
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
With qFlipper, you can update firmware, manage files, and repair corrupted firmware
﻿
﻿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:
1
Download the qFlipper installation file for your operating system.
<style>
    .qf-download-btn {
        display: flex;
        flex-direction: column;
        justify-content: center;
        width: 310px;
        height: 86px;
        text-align: center;
        color: #ffffff;
        font-size: 22px;
        line-height: 1.55;
        border-radius: 10px;
        background-color: #1faa20;
        transition: background-color 0.2s ease-in-out, color 0.2s ease-in-out, border-color 0.2s ease-in-out;
    }
    .qf-download-btn img {
        display: inline;
    }
</style>
<div style="display: flex; justify-content: center;">
    <a class="qf-download-btn" href="current"><span style="font-size: 125%;">Download qFlipper</span><span>for macOS</span></a>
</div>
<script>
    (() => {
      const qFlipper = { version: '', links: { macOS: '', Windows: '', Linux: '' } }
      let os = 'Windows'
      if (navigator.userAgent.includes('Macintosh')) { os = 'macOS' } else if (navigator.userAgent.includes('Linux') && !navigator.userAgent.includes('Android')) { os = 'Linux' } else { os = 'Windows' }
      function findLatest (versions) {
        let max = 0
        versions.forEach(e => { if (e.timestamp > max) { max = e.timestamp } })
        return versions.find(e => e.timestamp === max)
      }
      fetch('https://update.flipperzero.one/qFlipper/directory.json').then((response) => { return response.json() }).then(data => {
        const release = data.channels.find(e => e.id === 'release')
        let max = 0
        release.versions.forEach(e => { if (e.timestamp > max) { max = e.timestamp } })
        const latest = findLatest(release.versions)
        qFlipper.version = latest.version
        qFlipper.links.macOS = latest.files.find(e => e.target === 'macos/amd64').url
        qFlipper.links.Windows = latest.files.find(e => e.target === 'windows/amd64' && e.type === 'installer').url
        qFlipper.links.Linux = latest.files.find(e => e.target === 'linux/amd64').url
        document.querySelector('[href="current"]').innerHTML = '<span style="font-size: 125%;">Download qFlipper</span><span>for <img style="position: relative;top: -2px;margin: 0px 2px 0 8px;" src="https://cdn.flipperzero.one/' + os + '-white-logo.svg"/> ' + os + '</span>'
        document.querySelector('[href="current"]').setAttribute('href', qFlipper.links[os])
        document.querySelector('[href="macOS"]').setAttribute('href', qFlipper.links.macOS)
        document.querySelector('[href="Windows"]').setAttribute('href', qFlipper.links.Windows)
        document.querySelector('[href="Linux"]').setAttribute('href', qFlipper.links.Linux)
      })
      fetch('https://update.flipperzero.one/firmware/directory.json').then((response) => { return response.json() }).then(data => {
        const dev = data.channels.find(e => e.id === 'development')
        const rc = data.channels.find(e => e.id === 'release-candidate')
        const release = data.channels.find(e => e.id === 'release')
        let latest = findLatest(dev.versions)
        document.querySelector('[href="dev"]').innerHTML = 'Dev Unstable   <span style="color: rgb(253, 36, 36);">' + latest.version + '</span>'
        document.querySelector('[href="dev"]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)
        latest = findLatest(rc.versions)
        document.querySelector('[href="rc"]').innerHTML = 'Release Candidate   <span style="color: rgb(135, 42, 204);">' + latest.version + '</span>'
        document.querySelector('[href="rc"]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)
        latest = findLatest(release.versions)
        document.querySelector('[href="release"]').innerHTML = 'Latest Release   <span style="color: rgb(59, 207, 70);">' + latest.version + '</span>'
        document.querySelector('[href="release"]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)
      })
    })()
</script>
<style>
    .qf-download-btn {
        display: flex;
        flex-direction: column;
        justify-content: center;
        width: 310px;
        height: 86px;
        text-align: center;
        color: #ffffff;
        font-size: 22px;
        line-height: 1.55;
        border-radius: 10px;
        background-color: #1faa20;
        transition: background-color 0.2s ease-in-out, color 0.2s ease-in-out, border-color 0.2s ease-in-out;
    }
    .qf-download-btn img {
        display: inline;
    }
</style>
<div style="display: flex; justify-content: center;">
    <a class="qf-download-btn" href="current"><span style="font-size: 125%;">Download qFlipper</span><span>for macOS</span></a>
</div>
<script>
    (() => {
      const qFlipper = { version: '', links: { macOS: '', Windows: '', Linux: '' } }
      let os = 'Windows'
      if (navigator.userAgent.includes('Macintosh')) { os = 'macOS' } else if (navigator.userAgent.includes('Linux') && !navigator.userAgent.includes('Android')) { os = 'Linux' } else { os = 'Windows' }
      function findLatest (versions) {
        let max = 0
        versions.forEach(e => { if (e.timestamp > max) { max = e.timestamp } })
        return versions.find(e => e.timestamp === max)
      }
      fetch('https://update.flipperzero.one/qFlipper/directory.json').then((response) => { return response.json() }).then(data => {
        const release = data.channels.find(e => e.id === 'release')
        let max = 0
        release.versions.forEach(e => { if (e.timestamp > max) { max = e.timestamp } })
        const latest = findLatest(release.versions)
        qFlipper.version = latest.version
        qFlipper.links.macOS = latest.files.find(e => e.target === 'macos/amd64').url
        qFlipper.links.Windows = latest.files.find(e => e.target === 'windows/amd64' && e.type === 'installer').url
        qFlipper.links.Linux = latest.files.find(e => e.target === 'linux/amd64').url
        document.querySelector('[href="current"]').innerHTML = '<span style="font-size: 125%;">Download qFlipper</span><span>for <img style="position: relative;top: -2px;margin: 0px 2px 0 8px;" src="https://cdn.flipperzero.one/' + os + '-white-logo.svg"/> ' + os + '</span>'
        document.querySelector('[href="current"]').setAttribute('href', qFlipper.links[os])
        document.querySelector('[href="macOS"]').setAttribute('href', qFlipper.links.macOS)
        document.querySelector('[href="Windows"]').setAttribute('href', qFlipper.links.Windows)
        document.querySelector('[href="Linux"]').setAttribute('href', qFlipper.links.Linux)
      })
      fetch('https://update.flipperzero.one/firmware/directory.json').then((response) => { return response.json() }).then(data => {
        const dev = data.channels.find(e => e.id === 'development')
        const rc = data.channels.find(e => e.id === 'release-candidate')
        const release = data.channels.find(e => e.id === 'release')
        let latest = findLatest(dev.versions)
        document.querySelector('[href="dev"]').innerHTML = 'Dev Unstable   <span style="color: rgb(253, 36, 36);">' + latest.version + '</span>'
        document.querySelector('[href="dev"]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)
        latest = findLatest(rc.versions)
        document.querySelector('[href="rc"]').innerHTML = 'Release Candidate   <span style="color: rgb(135, 42, 204);">' + latest.version + '</span>'
        document.querySelector('[href="rc"]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)
        latest = findLatest(release.versions)
        document.querySelector('[href="release"]').innerHTML = 'Latest Release   <span style="color: rgb(59, 207, 70);">' + latest.version + '</span>'
        document.querySelector('[href="release"]').setAttribute('href', latest.files.find(e => e.target === 'f7' && e.type === 'full_dfu').url)
      })
    })()
</script>
﻿
You can also download qFlipper on the Flipper Zero Firmware update page.
2
Run the downloaded file and follow the instructions for your operating system.
%windows%Windows
%mac%macOS
%linux%Linux 
For Windows, qFlipper is compatible with Windows 10 and 11 only.
﻿
qFlipper is available on Windows
﻿
﻿
qFlipper is compatible with macOS version 10.14 or later. The application is optimized for M1 Apple Silicon Macs.
qFlipper is available on macOS
﻿
﻿
For Linux, qFlipper is downloaded in the AppImage format. Before running qFlipper on Linux, you need to make it executable:
Using the GUI
1
In the file manager, right-click the downloaded file.
2
Go to Properties -> Permissions.
3
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 checkbox if you are using Dolphin, or change the  Execute drop-down list to Anyone if you are using PCManFM.
4
Close the dialog.
5
Double-click on the AppImage file to run.
﻿
Using the Terminal
1
Open the Terminal.
2
Change to the directory containing the AppImage file.
3
Make the AppImage executable: chmod +x filename.AppImage.
4
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:
1
Connect your Flipper Zero to your computer via a USB cable.
2
On your computer, run qFlipper.
3
In qFlipper, go to the Advanced controls tab.
4
Click Update Channel and select a firmware version from the drop-down list (Release is recommended).
5
Click Update to start the update process.
Update your Flipper Zero via qFlipper
﻿
﻿
Having trouble updating firmware of your Flipper Zero? Check out the following pages:
﻿Internal storage repair﻿
﻿Firmware recovery﻿
﻿