https://github.com/rolehippie/wireguard

Ansible role to install and configure wireguard VPN
https://github.com/rolehippie/wireguard

ansible ansible-role hacktoberfest role

Last synced: 6 months ago
JSON representation

Ansible role to install and configure wireguard VPN

• Host: GitHub
• URL: https://github.com/rolehippie/wireguard
• Owner: rolehippie
• License: apache-2.0
• Created: 2018-08-23T12:39:28.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2026-01-12T14:38:39.000Z (6 months ago)
• Last Synced: 2026-01-12T18:06:23.947Z (6 months ago)
• Topics: ansible, ansible-role, hacktoberfest, role
• Language: Nix
• Size: 258 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# wireguard

[![Source Code](https://img.shields.io/badge/github-source%20code-blue?logo=github&logoColor=white)](https://github.com/rolehippie/wireguard)

[![General Workflow](https://github.com/rolehippie/wireguard/actions/workflows/general.yml/badge.svg)](https://github.com/rolehippie/wireguard/actions/workflows/general.yml)

[![Readme Workflow](https://github.com/rolehippie/wireguard/actions/workflows/docs.yml/badge.svg)](https://github.com/rolehippie/wireguard/actions/workflows/docs.yml)

[![Galaxy Workflow](https://github.com/rolehippie/wireguard/actions/workflows/galaxy.yml/badge.svg)](https://github.com/rolehippie/wireguard/actions/workflows/galaxy.yml)

[![License: Apache-2.0](https://img.shields.io/github/license/rolehippie/wireguard)](https://github.com/rolehippie/wireguard/blob/master/LICENSE)

[![Ansible Role](https://img.shields.io/badge/role-rolehippie.wireguard-blue)](https://galaxy.ansible.com/rolehippie/wireguard)

Ansible role to install and configure wireguard VPN.

## Sponsor

Building and improving this Ansible role have been sponsored by my current and previous employers like **[Cloudpunks GmbH](https://cloudpunks.de)** and **[Proact Deutschland GmbH](https://www.proact.eu)**.

## Table of contents

- [Requirements](#requirements)

- [Default Variables](#default-variables)

  - [wireguard_interface](#wireguard_interface)

  - [wireguard_ip](#wireguard_ip)

  - [wireguard_netmask](#wireguard_netmask)

  - [wireguard_packages](#wireguard_packages)

  - [wireguard_peers](#wireguard_peers)

  - [wireguard_port](#wireguard_port)

  - [wireguard_private](#wireguard_private)

  - [wireguard_public](#wireguard_public)

- [Discovered Tags](#discovered-tags)

- [Dependencies](#dependencies)

- [License](#license)

- [Author](#author)

---

## Requirements

- Minimum Ansible version: `2.10`

## Default Variables

### wireguard_interface

Interface to define

#### Default value

```YAML

wireguard_interface: wg0

```

### wireguard_ip

IP address of the wireguard node

#### Default value

```YAML

wireguard_ip:

```

### wireguard_netmask

Netmask of the wireguard node

#### Default value

```YAML

wireguard_netmask: 32

```

### wireguard_packages

List of packages to install

#### Default value

```YAML

wireguard_packages:

  - bridge-utils

  - linux-headers-generic

  - wireguard-tools

  - wireguard

  - "{{ 'wireguard-dkms' if ansible_distribution_version is version('24.04', '<')

    else omit }}"

```

### wireguard_peers

List of peers to connect to

#### Default value

```YAML

wireguard_peers: []

```

### wireguard_port

Port to bind to

#### Default value

```YAML

wireguard_port: 51820

```

### wireguard_private

Private encryption key

#### Default value

```YAML

wireguard_private:

```

### wireguard_public

Public encryption key

#### Default value

```YAML

wireguard_public:

```

## Discovered Tags

**_wireguard_**

## Dependencies

- None

## License

Apache-2.0

## Author

[Thomas Boerger](https://github.com/tboerger)