joenyland.wireguard

Installs WireGuard.

Requirements

None.

Role Variables

wireguard_interfaces

This defines the WireGuard network interfaces you want to set up.

Example

wireguard_interfaces:
  wg0:
    address:        # IP address for the interface
    mtu:            # Maximum Transmission Unit size
    post_up:        # Commands to run after the interface is up
      - wg set %i private-key /etc/wireguard/private.key # Recommended. The key is generated when the role is installed.
    dns:             # Optional DNS settings
      - 1.1.1.1      # Primary DNS server
      - 2.2.2.2      # Secondary DNS server
      - vpn          # Search domain
    peers:          # List of peers (connections)
      - name:       # Optional name for the peer
        public_key: # Public key of the peer
        allowed_ips: # IPs allowed for the peer
        endpoint:    # Optional endpoint address
        keep_alive:  # Optional keep-alive setting
    enabled: true   # Should this interface start automatically?
    state: started  # What should the interface's state be?

Dependencies

None.

Example Playbook

- hosts: server
  roles:
    - joenyland.wireguard

License

MIT

Author Information

⌨️ with ❤️ by Joe Nyland