Skip to content

diegobernardes/openwrt

Repository files navigation

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

  • mise - At the first run execute mise install to bring all dependencies into scope.

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

About

Ansible managed OpenWrt configuration for a NanoPi R6S home router

Topics

Resources

Stars

Watchers

Forks

Contributors