Skip to content

Upgrading

Jump to bottom
lodordev edited this page Jul 5, 2026 · 2 revisions

Upgrading

How to move an already-installed card to a new LodorOS release. Your pairing config and saves are not in the zip, so re-extracting over the card doesn't touch them.

The short version

  1. Back up the card first. Copy the whole card to your computer — or at minimum Tools/<platform>/Lodor.pak/config.json (your pairing + transport credentials) and Saves/.
  2. Download the new release zip and extract it over the card root, overwriting, hidden folders included — same discipline as Installation: use a real unzip (unzip -o), not a Finder/Explorer drag, which can silently skip the dot-folders.
  3. Eject cleanly (diskutil eject on macOS; also run dot_clean there). FAT32 has no journal — a yanked card can stop mounting.
  4. Boot. Done — no re-pairing needed.

What's preserved

These are not in the release zip, so extraction never touches them:

  • Tools/<platform>/Lodor.pak/config.json — your server pairing, tokens, and transport setup.
  • Your saves — the zip ships Saves/ as an empty folder only; existing save files are untouched.
  • Downloaded ROMs and box art — anything the device pulled from your server stays.

What's replaced

  • The launcher, the sync engine, and every pak's code (.system/, Emus/, Tools/<platform>/*.pak script/binary files).
  • Tools/<platform>/Lodor.pak/settings.conf — the zip ships a default copy, so options you set in the Settings tool reset to defaults. Reapply them after upgrading.
  • .userdata/<platform>/auto.sh — the zip ships the stock boot script (it already starts the sync daemon, so normal installs lose nothing). If you added your own lines to it, copy them aside first.
  • A few shipped per-emulator defaults (.userdata/<platform>/<emu>/minarch.cfg on some devices) — in-emulator option tweaks for those specific systems reset to the tuned defaults.

Upgrading from 0.9.4.x on a non-Miyoo device

0.9.5 and later are Miyoo-only. If your card runs v0.9.4.1 on an Anbernic H700 (rg35xxplus) or Powkiddy RGB30 (rgb30), do not extract 0.9.5 over it — it no longer contains your device's platform folder.

  • H700 owners: the recommended path is Lodor for muOS — the same sync engine as a native muOS app. Your saves live on your RomM server, so after pairing the muOS app to the same server, everything follows you.
  • Your existing v0.9.4.1 card keeps working as-is; that release stays available.

If something breaks after an upgrade, see Troubleshooting — and your step-1 backup means you can always restore the old card as-was.

Clone this wiki locally