0
0
wireguard-mesh-network-role/README.md

23 lines
983 B
Markdown
Raw Normal View History

2023-11-08 01:13:53 +08:00
# Ansible role for creating a Wireguard-based mesh network
An Ansible role to automate the creation of a Wireguard-based mesh network, allowing servers to communicate between each other using a private, secure VPN without the need for a central node.
The role uses the `wg-quick` control which is also exposed via a Systemd service, such that the interface can be brought up automatically on boot. After the mesh network is created, connectivity is verified with a ping task. If you are behind NAT or a stateful firewall, you might need to set `PersistentKeepalive`.
## Example Playbook
```
---
- name: Wireguard
hosts: all
any_errors_fatal: true
gather_facts: yes
become: true
roles:
- create-wireguard-mesh-network
```
## Credits
This role is based on [Tyler-OBrien/wireguard-mesh-network-ansible](https://github.com/Tyler-OBrien/wireguard-mesh-network-ansible), which is based on [jawher/automation-wireguard](https://github.com/jawher/automation-wireguard).