Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/joenyland/ansible-wireguard-role

Last synced: 8 days ago
JSON representation

Host: GitHub
URL: https://github.com/joenyland/ansible-wireguard-role
Owner: JoeNyland
Created: 2023-02-20T21:12:46.000Z (almost 2 years ago)
Default Branch: main
Last Pushed: 2024-08-19T06:27:30.000Z (4 months ago)
Last Synced: 2024-12-06T21:08:36.262Z (24 days ago)
Language: Jinja
Size: 21.5 KB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        joenyland.wireguard

===================

[![CI](https://github.com/JoeNyland/ansible-wireguard-role/actions/workflows/ci.yml/badge.svg)](https://github.com/JoeNyland/ansible-wireguard-role/actions/workflows/ci.yml)

Installs [WireGuard](https://www.wireguard.com/).

Requirements

------------

None.

Role Variables

--------------

### `wireguard_interfaces`

Defines the WireGuard interfaces to configure.

#### Example

```yaml

wireguard_interfaces:

  wg0:

    address:

    mtu:

    post_up:

      - wg set %i private-key /etc/wireguard/private.key # Recommended. This key is generated on install of the role.

    dns: # Optional

      - 1.1.1.1 # DNS server 1

      - 2.2.2.2 # DNS server 2

      - vpn # Search domain

    peers:

      - name: # Optional

        public_key:

        allowed_ips:

        endpoint:  # Optional

        keep_alive: # Optional

    enabled: true # Should this interface start at boot?

    state: started # What state should the interface be in?

```

Dependencies

------------

None.

Example Playbook

----------------

```yaml

- hosts: server

  roles:

    - joenyland.wireguard

```

License

-------

MIT

Author Information

------------------

⌨️ with ❤️ by [Joe Nyland](https://joe.nyland.io)