Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nn708/ansible-openwrt
Ansible collection to configure your OpenWrt devices more quickly and automatically (without Python)
https://github.com/nn708/ansible-openwrt
access-point ansible ansible-collection ansible-role automation lede network-automation networking openwrt wifi wireless
Last synced: about 1 month ago
JSON representation
Ansible collection to configure your OpenWrt devices more quickly and automatically (without Python)
- Host: GitHub
- URL: https://github.com/nn708/ansible-openwrt
- Owner: NN708
- License: gpl-3.0
- Created: 2021-05-30T09:26:02.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-01-04T03:02:31.000Z (10 months ago)
- Last Synced: 2024-10-13T07:22:56.327Z (about 1 month ago)
- Topics: access-point, ansible, ansible-collection, ansible-role, automation, lede, network-automation, networking, openwrt, wifi, wireless
- Homepage: https://galaxy.ansible.com/nn708/openwrt
- Size: 67.4 KB
- Stars: 60
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ansible Collection for OpenWrt
Ansible collection to configure your OpenWrt devices more quickly and automatically (without Python).
## Installation
1. [Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html) 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](https://github.com/NN708/ansible-openwrt/tree/master/roles/ddns)
+ [nn708.openwrt.dhcp](https://github.com/NN708/ansible-openwrt/tree/master/roles/dhcp)
+ [nn708.openwrt.dumb_ap](https://github.com/NN708/ansible-openwrt/tree/master/roles/dumb_ap)
+ [nn708.openwrt.firewall](https://github.com/NN708/ansible-openwrt/tree/master/roles/firewall)
+ [nn708.openwrt.network](https://github.com/NN708/ansible-openwrt/tree/master/roles/network)
+ [nn708.openwrt.system](https://github.com/NN708/ansible-openwrt/tree/master/roles/system)
+ [nn708.openwrt.wireguard](https://github.com/NN708/ansible-openwrt/tree/master/roles/wireguard)
+ [nn708.openwrt.wireless](https://github.com/NN708/ansible-openwrt/tree/master/roles/wireless)
+ [nn708.openwrt.wireless_enterprise](https://github.com/NN708/ansible-openwrt/tree/master/roles/wireless_enterprise)
## Example Playbook
This is a minimal working example to set up a basic wireless router:
```yaml
---
- 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](https://github.com/gekmihesg/ansible-openwrt#example-playbook) for example inventory file.
## License
Licensed under [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.txt).