Basics
Firmware update

﻿
We are constantly updating the Flipper Zero firmware, which is why it is important to update your Flipper Zero regularly. You can update your Flipper Zero via the Flipper Mobile App or qFlipper.
There are three firmware update channels:
﻿DEVELOPMENT (Dev): The ongoing development is constantly building a new version of the firmware with every new commit, often multiple times per day. This Development 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): The version submitted for validation testing to the 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 is extensively tested to ensure its reliability and is therefore recommended 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 the Flipper Zero firmware by visiting this page.
﻿
Updating via Flipper Mobile App
With the 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 the 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 the 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 the 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 the Flipper Mobile App is installed on your phone. -> App Store or Google Play.

Reboot your Flipper Zero. -> How to reboot Flipper Zero.
Updating Flipper Zero
To update your Flipper Zero via the Flipper Mobile App, do the following:
1
In the Main Menu tab, tap Update Channel and select a firmware (Release is recommended).
2
Tap the Update button.
3
Tap the Update button to confirm the action.
The update process via the Flipper Mobile App usually takes 2-3 minutes.
﻿
You can update your Flipper Zero via the 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. -> How to reboot Flipper Zero.

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. The qFlipper application is available on Windows, macOS, and Linux. To install the qFlipper application 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, the qFlipper application is compatible with Windows 10 and 11 only.
﻿
qFlipper is available on Windows
﻿
﻿
The qFlipper application 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, the qFlipper application is downloaded in the AppImage format. Before running the application on Linux, you need to make the application 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 will 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 the qFlipper application, do the following:
1
Connect your Flipper Zero to your computer via a USB cable.
2
On your computer, run the qFlipper application.
3
In the qFlipper application, 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
﻿
﻿
Can't update the firmware of your Flipper Zero? Check out the following pages:
﻿Internal storage repair﻿
﻿Firmware recovery﻿
﻿