OpenWrt

Ansible project to configure a device as an OpenWrt router.

This project has no objective on becoming a template to be used by others. There is hardcoded information in most files. Use as example for your own OpenWrt installations.

The router configured by this repository is a NanoPi R6S. It handles a single 1Gbps symmetrical internet connection, and a 2.5gbps lan connection.

Why?

Do I need all this for my network? No.
It's overkill? Yes.
Would I do it again? Yes!

Prerequisites

• Nix with flakes enabled — provides the pinned dev toolchain (flake.nix + flake.lock).
• direnv with nix-direnv — run direnv allow once and the toolchain loads automatically whenever you cd into the repo. Without direnv, run nix develop to enter the dev shell manually.

Ansible collections are not managed by Nix — run task setup once (see below) to install them via ansible-galaxy.

Quick Start

1. Flash the router — see Firmware for building and flashing the image.
2. Create a .vault_pass file at the root containing the vault password, with permissions 600.
3. Run task setup (once, to install Ansible collections)
4. Run task apply

Documentation

Document	Description
Firmware	Building, flashing, and upgrading the firmware
Improvements	Planned enhancements