Coming from v1 (YAML config)

Magic Box firmware v2 runs on a web UI — you configure everything from your phone, no files to edit.

Magic Box firmware v1 (last version v1.7) used YAML config files on the SD card. If that’s where you’re coming from, your old config doesn’t drop straight into v2 — but v2 has a tool that reads it and brings your profiles across. Four steps.

What carries over

• Profiles
• Channel layout
• Joystick / throttle / pedal bindings
• Output protocol settings (PPM, SBUS, IBUS)

What doesn’t: PIN, theme, display preferences (quick to set those again on v2). Transforms, expo, mixing and CRSF output are v2-only features — they didn’t exist on v1, so there’s nothing to import. You’ll set them up fresh on v2 if you want them.

Step 1 — Save your v1 config

If your v1 Magic Box still works:

1. Power it off.
2. Pull the SD card. Put it in a card reader on your computer.
3. Find the magic-box drive. Inside, copy the whole config folder to your computer.
4. Zip it up if you want a single file. Don’t unzip individual files inside — keep the folder structure.

Keep that file or folder somewhere you can grab it from your phone or laptop later.

Step 2 — Flash v2

Get a v2 SD card image (see OS Images) and flash it onto your SD card. Step-by-step in How to Update.

When the freshly flashed Magic Box boots, you’ll get an empty configuration. That’s expected.

Got a spare SD card? Use it.

v2 is a fresh release and still going through intensive testing. If you have a second SD card (32 GB or larger) lying around, flash v2 onto that one instead of overwriting your v1 card. If anything misbehaves on v2, you swap your old v1 card back in and you’re flying again in 30 seconds — no recovery, no reflash.

When you’re confident on v2, you can repurpose the v1 card later.

Step 3 — Import your v1 config

Connect to the web UI

Two ways to reach Magic Box from your phone or laptop:

• Wi-Fi hotspot (default, no router needed). Magic Box broadcasts its own Wi-Fi network — MagicBox-XXXX. Join it, then open http://10.11.12.13 in your browser.
• Home network via USB-Ethernet — plug a USB-Ethernet adapter into Magic Box and a cable into your router. Magic Box gets an IP from your router and is reachable from any device on your network.

The Wi-Fi name and both IPs are shown on the Magic Box screen — Wi-Fi hotspot IP, plus the wired LAN IP if you’ve plugged in a USB-Ethernet adapter.

Import the package

1. Open the Magic Box web UI in your browser.
2. Go to System.
3. Tap Import v1 package and pick the v1 config you saved in Step 1.
4. Magic Box reads it and pulls your profiles, bindings and channels in.
5. The page tells you what came across cleanly and flags anything that needs a second look.

Step 4 — Verify on the bench

Before you fly:

1. Open Profiles. Confirm your old profiles are listed.
2. For each profile, open Channels and wiggle every stick, button and switch. Watch the live preview. Make sure each input goes where you expect.
3. Anything missing or wrong? Fix it in the web UI. While you’re there, this is a good moment to play with the new v2 features — channel transforms, expo curves and mixing — that v1 never had.
4. Re-set your PIN, theme and display preferences if you used them.
5. Make a v2 backup — see Backup & Restore.

Now go fly.

Staying on v1.x?

No pressure. v1.7 still works as long as you don’t reflash. The full v1 user guide and release history live on the v1 docs on GitBook ↗.

Stuck?

Bring your v1 config and a description of what isn’t migrating to the SilverFox RC Facebook group — we’ll help.