Ansible Collection for OpenWrt

Ansible collection to configure your OpenWrt devices more quickly and automatically (without Python).

Installation

1. Ansible should be installed on your control node, but nothing needs to be installed on your OpenWrt devices.

2. This collection depends on gekmihesg.openwrt. Install it using

   ansible-galaxy install gekmihesg.openwrt
   

3. Install this collection using

   ansible-galaxy collection install nn708.openwrt
   

Content

This collection includes these roles:

• nn708.openwrt.ddns
• nn708.openwrt.dhcp
• nn708.openwrt.dumb_ap
• nn708.openwrt.firewall
• nn708.openwrt.network
• nn708.openwrt.system
• nn708.openwrt.wireguard
• nn708.openwrt.wireless
• nn708.openwrt.wireless_enterprise

Example Playbook

This is a minimal working example to set up a basic wireless router:

---
- hosts: openwrt

  vars:
    ansible_user: root
    openwrt_network_wan_proto: pppoe
    openwrt_network_wan_username: my-user
    openwrt_network_wan_password: my-passwd
    openwrt_system_zonename: Asia/Shanghai
    openwrt_wireless_country: CN
    openwrt_wireless_ssid: my-wifi
    openwrt_wireless_encryption: psk2
    openwrt_wireless_key: my-passwd

  roles:
    - nn708.openwrt.network
    - nn708.openwrt.system
    - nn708.openwrt.wireless

Because of using gekmihesg.openwrt, openwrt should be used as the group name of hosts. See gekmihesg/ansible-openwrt#example-playbook for example inventory file.

License

Licensed under GNU General Public License v3.0.