Skip to main content

Tutorials

Diskless mini PC router in five minutes

Boot the routerd live ISO, answer the text wizard, save the configuration to a USB stick, and turn a small x86 mini PC into a persistent router without installing an OS to the internal disk.

Start the diskless walkthrough

Diskless mini PC flow

Pick a path

GoalTutorial
Install routerd from a release archiveInstall
Build a first router from YAMLGetting started
Configure WAN-side acquisition and tunnelsWAN-side services
Configure DHCP, DNS, RA, and NTP on LANLAN-side services
Add a conservative firewall baselineBasic firewall
Start from NixOSNixOS getting started
Start from FreeBSDFreeBSD getting started

routerd is unusual because the same resource model can describe a virtual lab router between SDN/VNET segments and a diskless physical router on a mini PC. Use the tutorial that matches your first deployment, then reuse the same resources as the network grows.