--- title: #10: Run your own Flipper One slug: one/dev-log/10 docTags: createdAt: 2026-10-16T15:29:42.098Z --- ![Single-board computer runs Flipper OS, laptop displays FlipCTL web interface](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/cHmpu0IjHDsTRQPY8ertS_dev-log-10-main-image.jpg) We're building Flipper OS, the Linux-based operating system for Flipper One. And you don't have to wait for the official release to try it out. Install Flipper OS on a supported single-board computer (SBC) and explore Flipper One UI, App Manager, and ready-made OS profiles — all before Flipper One is out. Read on to get started. ::embed[]{url="https://youtu.be/QENMEUr5oPo"} *** ## What you can try today Once Flipper OS is installed, you can explore: - **FlipCTL UI** — try the pixel-perfect UI designed for Flipper One right in your browser. - **App Manager** — install and run apps right from FlipCTL UI. Yes, Doom already runs. - **OS profiles** — try five profiles (Minimal, No Graphics, TV Media Box, Router, and Desktop), clone them, and create your own. *** ## Flipper OS without Flipper One Flipper OS is built for the **Rockchip RK3576** system-on-chip (SoC). That means it can also run on other RK3576-based SBCs already on the market. You might even own one. ![Rockchip RK3576 SoC on a single-board computer. Supported SBCs: Armsom Sige5, FireFly ROC-RK3576-PC, Luckfox Omni3576, NanoPi M5](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/V4t-QMMJlbrHLT4IpeBTe_flipper-os-supported-boards.jpg) SBCs that can now run Flipper OS: \- **Armsom Sige5** - recommended \- **Banana Pi BPI-M5 Pro** \- **FireFly ROC-RK3576-PC** \- **Luckfox Omni3576** *** ## What you'll need ![Supported single-board computer, power supply, microSD card with a card reader, monitor, keyboard and mouse](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/mzs_vcQI0lXcuoRmZ8vRY_flipper-os-what-you-will-need.jpg) To try Flipper OS, you'll need: - A supported SBC - A power supply for the SBC - A microSD card (8 GB or larger) + card reader - A monitor, keyboard, and mouse *** ## Install Flipper OS and open FlipCTL UI The easiest way to get Flipper OS on an SBC is to flash the OS image to a microSD card, then insert it into your SBC and boot it up. Once it boots, you can open FlipCTL UI in a browser on another PC or laptop connected to the same network. :::hint{type="info"} For alternative installation methods and detailed instructions, see the [How to install a Linux image](#) page. ::: :::::ExpandableHeading ### Step 1. Write the OS image on a microSD card :::hint{type="danger"} **Warning:** The microSD card will be erased during the OS writing process! ::: ::::WorkflowBlock :::WorkflowBlockItem [Download](https://dl-linux-images.flipp.dev/full-img/) or [build](docId\:Gjv9E-r2gBe20VjYUG0MG) an OS image. Use `debian-512-[Target name]-build-[Build ID].img.zst` file, where the `[Target name]` identifies your board: - `sige5` - Armsom Sige5 or Banana Pi BPI-M5 Pro. - `rock-pc` - FireFly ROC-RK3576-PC. - `omni3576` - Luckfox Omni3576. ::: :::WorkflowBlockItem Connect an 8 GB or larger microSD card to your PC using a card reader. ::: :::WorkflowBlockItem Download and run [Raspberry Pi Imager](https://www.raspberrypi.com/software/) on your PC. ::: :::WorkflowBlockItem Click the **OS** tab. Then click **Use custom**, select the `.zst` OS image and click **NEXT**. ![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/moqugInYjCyynHWBZqdIP_flipper-os-write-os-image-step1.png) ::: :::WorkflowBlockItem In the **Storage** tab select your microSD card in the list and click **NEXT**. ![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/KjKkq-9wZwz7P5nHjg2cF_flipper-os-write-os-image-step2.png) ::: :::WorkflowBlockItem On the **Writing** tab click **WRITE** and wait until the process finishes. ![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/LjWfzkQcqALF-jnegTZT7_flipper-os-write-os-image-step3.png) ::: :::WorkflowBlockItem Insert the microSD card into your board. ::: :::: ::::: :::::ExpandableHeading ### Step 2. Erase the eMMC bootloader (optional) All RK3576-based boards in this guide try to boot from storage in the following order: **eMMC → microSD → USB**. Even with a bootable microSD card inserted, the RK3576 tries to boot from eMMC first. To boot from the microSD card, erase the first 32 MB of the eMMC to kill its bootloader. :::hint{type="info"} You can skip this step if there's no bootable OS on the eMMC storage. The RK3576 will try to boot from the microSD card right away. ::: To erase the eMMC bootloader, follow these steps: ::::WorkflowBlock :::WorkflowBlockItem Boot your board from eMMC. If it doesn't run a Linux-based OS, install one on the eMMC first. ::: :::WorkflowBlockItem Download the [erase-emmc.sh](https://cdn.flipperzero.one/erase-emmc.sh) script to your board. ::: :::WorkflowBlockItem Open a terminal on the board (directly or via SSH). In the directory containing the script, run the script: `sudo chmod +x erase-emmc.sh` `sudo bash ./erase-emmc.sh` ::: :::WorkflowBlockItem Check that the script found the right eMMC storage and confirm the erasing. ::: :::WorkflowBlockItem Remove the microSD card and reboot the board. The OS should no longer boot. ::: :::WorkflowBlockItem Insert the microSD card containing Flipper OS and reboot the board. ::: :::: ::::: :::::::ExpandableHeading ### Step 3: Connect your SBC to your LAN Follow the steps below to connect to your board via Ethernet or Wi-Fi and get the board's IPv4 address — you'll need it for remote control. ::::::Tabs :::::Tab{title="Ethernet"} ![FlipCTL web interface connected over Ethernet](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/zp58OBnH6OeMWGQqvRmA4_flipctl-ethernet-connection.jpg) ::::WorkflowBlock :::WorkflowBlockItem Connect your board to your LAN via Ethernet cable. ::: :::WorkflowBlockItem Get board's IPv4 address. There two basic ways: \- In the clients list of your router web-interface. \- Connect a monitor and mouse to your board, open **Networks** in the system tray and get the IPv4 address in the wired connection details: ```javascript ![FlipCTL web interface connected over Ethernet](/files/pics/dev-log/10/flipper-os-ethernet-connection-details.jpg) ``` ::: :::: ::::: :::::Tab{title="Wi-Fi"} ![FlipCTL web interface connected over Wi-Fi](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/8Davy9KPGV7mc2d84PTfx_flipctl-wifi-connection.jpg) ::::WorkflowBlock :::WorkflowBlockItem Connect a monitor and mouse to your board. ::: :::WorkflowBlockItem Click **Networks** icon in the system tray and select your Wi-Fi network, and enter its password. ![FlipCTL web interface connected over Ethernet](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/O8PmnaBzADJ_nHRWmKPfs_flipper-os-wifi-provisioning.jpg) ::: :::WorkflowBlockItem Get the IPv4 address in the Wi-Fi connection details: ![FlipCTL web interface connected over Ethernet](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/8Djtgyuo3UzV-_ntqCFm6_flipper-os-wifi-connection-details.jpg) ::: :::: ::::: :::::: ::::::: *** ## Try FlipCTL remote control Open this URL in a browser to access the FlipCTL web interface: `http://[Board IPv4 address]:8899`. :::Iframe{code=""} ::: ㅤ You can use your mouse to navigate the interface, launch apps, and open the boot menu to switch between profiles. Keyboard controls are available too. Click **Show controls** in the top-left corner to view the keyboard shortcuts. ![FlipCTL web interface keyboard shortcuts](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/mP8QQqxLYxfFoCr1IbZ-X_flipctl-web-interface-controls.jpg "FlipCTL web interface keyboard shortcuts") *** ### Install apps using App Manager App Manager lets you install apps from an online catalog adapted for the Flipper One's screen and controls. Go to **App Manager → Install** to browse available apps, select one, and press **Install**. ![Over a dozen apps already available in App Manager](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/oSVJEVdcjmY-49B-zoLh7_flipper-os-app-manager.jpg "Over a dozen apps already available in App Manager") Installed apps appear in the Apps folder in the main menu, organized by category. *** ### Explore OS profiles Go to **Settings → Boot Menu**. It's the same menu that appears on the Flipper One display at startup. We covered it in more detail in [Dev Log #9](docId\:DIJsj7iLYPAwo05iJXp_g), and you can see it in action in the video below. ::embed[]{url="https://youtu.be/aLRK_TnJwuA"} Each OS profile includes a root filesystem (rootfs), a Linux kernel, and a Device Tree. Think of each profile as a separate Debian installation, with its own apps, settings, data, and Linux kernel. - **Minimal:** A minimal Linux system without desktop environment. - **No Graphics:** A minimal system with video hardware disabled to reduce power consumption and free up system resources. - **Desktop:** A full Debian desktop environment powered by [KDE](https://kde.org/), with Chromium, MPV (with H.264 hardware acceleration) preinstalled. - **TV Media Box:** Automatically launches [Kodi](https://kodi.tv/) player with HDMI-CEC enabled, so you can control it using your TV remote. - **Router:** A minimal system without a desktop environment configured as a Wi-Fi router. The ETH0 port acts as the WAN port to connect to your internet provider. The device creates a Wi-Fi access point and shares the internet connection over Wi-Fi, ETH1, and USB-C. An `iperf3` server starts automatically for network speed testing. You can boot, clone, and customize these OS profiles. The FlipCTL web interface starts automatically in all built-in profiles, so you can control the system from your browser. *** ## Join Flipper One development and make your contribution Flipper OS is under active development. We welcome everyone who wants to test it, share feedback, and help shape its future. - **Pick a task:** Browse the [🚧 Open tasks](https://docs.flipper.net/one/open-tasks) page for ways to contribute. - **Share your project:** Built something that helps test or improve Flipper One? Add it to the [community projects](docId\:Xqaz9ZzclnBl0Awu3zH6q) page. - **Contribute module & accessory 3D models:** Check out the [contribution guide](docId:0DDVbIoaWJaz2P653X569) and open a pull request in [flipperdevices/flipperone-mechanics](https://github.com/flipperdevices/flipperone-mechanics). See you in the next Dev Log!