Skip to content

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

License

Notifications You must be signed in to change notification settings

NN708/ansible-openwrt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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:

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.