Miyoo Mini — Onion OS setup
Quick answer
Button combo
(SD: FAT32)(SD: FAT32)insert SDPOWERPackage Manager (START twiceA)
Steps
- 1Check the stock firmware first: the original Mini needs base firmware 20220419 or later (see the Onion compatibility list); update via Miyoo's official firmware if older.
- 2Format your microSD/TF card as FAT32 with an MBR partition (Windows >32GB: Rufus → Large FAT32, MBR, 32KB cluster; macOS: Disk Utility → Erase → MS-DOS (FAT) → Master Boot Record).
- 3Download the latest Onion-v4.x.x.zip from the OnionUI GitHub releases page and extract it.
- 4Copy the contents (the folders .tmp_update, BIOS, Media, miyoo, miyoo354, RetroArch, Themes) to the SD root — not inside a subfolder.
- 5Insert the card and press POWER; the Quick Guide and Package Manager run, then pick systems, press START twice and A to finish (the Mini powers off — turn it back on).
Last verified: 2026-06-20Source: onionui.github.io
The original Miyoo Mini is a SigmaStar device, so Onion OS installs the same way as on the Mini Plus: there is no internal flashing, everything lives on the microSD. Make sure the stock firmware is recent enough (20220419 or later for current Onion), format the card as FAT32 (MBR), unzip the Onion release to the card root, and the device runs its installer on first boot. After the Package Manager finishes, add ROMs to the Roms subfolders and BIOS files to BIOS. On Windows, Onion Desktop Tools can format, download and install Onion in one step.
FAQ
- Which stock firmware does the original Mini need before Onion OS?
- Base firmware 20220419 or later for current Onion releases. The original Mini and the Mini Plus use different minimum firmware — check the Onion installation page's compatibility list and update the stock firmware from Miyoo if yours is older.
- Why must the card be FAT32 and not exFAT?
- The Onion installer and the Mini's boot loader read FAT32. Cards over 32GB cannot be set to FAT32 by Windows' built-in formatter — use Rufus (Large FAT32), the SD Card Formatter or Onion Desktop Tools instead.
- Do I copy the folder or the files inside it?
- Copy the contents of the unzipped Onion folder — the 7 folders (.tmp_update, BIOS, Media, miyoo, miyoo354, RetroArch, Themes) must sit at the root of the card, not inside a subfolder.