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. Define a .vault_pass at the root of the project with the vault password:

    echo "your-secure-password" > .vault_pass
    chmod 600 .vault_pass
  2. Run task apply

    Parameter Description
    TARGET=router|router_factory Target device. Inferred if not set
    ROLE=<role> Single role to execute. All roles if omitted

    Extra ansible args can be passed after --.

Documentation

Document Description
Bootstrap Initial device setup and provisioning
Improvements Planned enhancements

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages