Running OrBit on NixOS (unofficial notes)

I couldn't find a clean way to run OrBit on my NixOS laptop, so this repo is my personal workaround using Wine + some helper scripts.

My use case is a 2022 Polestar 2: I use OrBit to rebuild/update modules and unlock Matrix LED behavior that is enabled on EU builds.

If you're trying something similar, feel free to use this as a starting point.

This is experimental and not an official setup.

What this includes

• Scripts to probe OBD Ethernet and launch OrBit with Wine
• Nix flake apps so everything is runnable with nix run
• Optional update/rollback helpers for safer testing

It does not include OrBit installers, vendor configs, or any private/proprietary data.

Quick start

From this directory:

nix run .#orbit-start

That runs OBD probing first, then starts OrBit.

If you just want to launch OrBit:

nix run .#orbit-run

Commands

• nix run .#orbit-start - probe network then launch
• nix run .#orbit-run - launch only
• nix run .#orbit-obd-debug - probe only
• nix run .#orbit-obd-restore - reset interface IP
• nix run .#orbit-update -- /path/to/OrBitInstaller.exe - run installer with backup
• nix run .#orbit-rollback - restore latest backup

Update / rollback

Update with an installer you downloaded yourself:

nix run .#orbit-update -- /path/to/OrBitInstaller.exe

Rollback if an update breaks login or launch:

nix run .#orbit-rollback

List backups:

nix run .#orbit-rollback -- --list

Environment vars (optional)

• ORBIT_EXE (default: ~/.wine/drive_c/users/$USER/AppData/Local/OrBitApp/OrBitRun.exe)
• WINEPREFIX (default: ~/.wine)
• OBD_IFACE (force interface)
• ORBIT_INSTALLER (used by orbit-update)
• ORBIT_BACKUP_DIR (default: ~/.orbit-runner-backups)

Screenshot

Notes

• Tested for personal use; expect rough edges.
• If you publish your own fork, keep private configs and installer files out of git.