Ansible Collection for OpenWrt
Ansible collection to configure your OpenWrt devices more quickly and automatically (without Python).
Installation
-
Ansible should be installed on your control node, but nothing needs to be installed on your OpenWrt devices.
-
This collection depends on
gekmihesg.openwrt. Install it usingansible-galaxy install gekmihesg.openwrt -
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
- 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,openwrtshould 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.