A modern, reproducible OpenWrt build environment powered by Nix. No root required.
nix develop github:mingww64/openwrt-nss-builder --command build-nss-image --profile mr7350You can run this builder without cloning the repo. To customize, drop these in your current directory:
- 📂
./patches/- Auto-applied.patchfiles. - 📝
./packages.txt- Custom package list.1 - ⚙️
./config.txt- Extra configuration fragments.1
For local development:
git clone https://github.com/mingww64/openwrt-nss-builder && cd openwrt-nss-builder
nix develop # Mounts FUSE environment
build-nss-image --profile mr7350Tip
check config-nss.seed available profiles.
--profile <name>: Fuzzy search for device (e.g.,mr7350,ipq60xx).--menuconfig: Classicmake menuconfigUI.--sync-packages: Sync packages from a live router via SSH.
The environment uses fuse-overlayfs to create a writable view of pinned Nix inputs.
- Update:
nix flake update && nix develop(Detects changes and remounts automatically). - Clean Mounts:
unmount-nss-mounts(Tears down FUSE, keeps build artifacts). - Full Wipe:
clean-nss-mounts(Wipes everything for a fresh start).
- Default LuCI Credentials:
admin/passwd - Cloudflare WARP: A free WARP account is automatically registered on the fly to provision a WireGuard interface. Policy-Based Routing (PBR) rules will dynamically toggle based on the tunnel's connectivity to ensure seamless fallback.