From 73355d27ed8b882954e719d4c5ab9bb660f8ce19 Mon Sep 17 00:00:00 2001
From: Julien Dessaux
Date: Fri, 20 Aug 2021 17:57:39 +0200
Subject: Added wireguard docs article for alpine

---
 content/docs/alpine/wireguard.md | 61 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 content/docs/alpine/wireguard.md

(limited to 'content/docs')

diff --git a/content/docs/alpine/wireguard.md b/content/docs/alpine/wireguard.md
new file mode 100644
index 0000000..9652d01
--- /dev/null
+++ b/content/docs/alpine/wireguard.md
@@ -0,0 +1,61 @@
+---
+title: Wireguard
+description: How to configure a wireguard endpoint on Alpine
+---
+
+## Introduction
+
+This article explains how to configure wireguard on Alpine.
+
+## Configuration example
+
+Here is a `/etc/wireguard/wg0.conf` configuration example to create a tunnel listening on udp port 342 and a remote peers :
+```cfg
+[Interface]
+PrivateKey = MzrfXLmSfTaCpkJWKwNlCSD20eDq7fo18aJ3Dl1D0gA=
+ListenPort = 342
+
+[Peer]
+PublicKey = R4A01RXXqRJSY9TiKQrZGR85HsFNSXxhRKKEu/bEdTQ=
+Endpoint = 168.119.114.183:342
+AllowedIPs = 10.1.2.9/32
+PersistentKeepalive = 60
+```
+
+Note that there is no ip address in the Interface section, contrary to other operating systems. Putting one here is invalid and wg will fail with an error.
+
+Your private key goes on the first line as argument to `wgkey`, the other keys are public keys for each peer. In this example I setup a client that can be hidden behind nat therefore I configure a `PersistentKeepalive`. If your host has a public IP this line is not needed.
+
+To activate the interface configuration, edit `/etc/network/interfaces` :
+```sh
+auto wg0
+iface wg0 inet static
+requires eth0
+use wireguard
+address 10.1.2.3/24
+```
+
+Then run `ifup wg0`.
+
+## Administration
+
+Private keys can be generated with the following command :
+{{< highlight sh >}}
+openssl rand -base64 32
+{{< /highlight >}}
+
+The tunnel can be managed with the `wg` command:
+```sh
+root@hurricane:~# wg
+interface: wg0
+  public key: 7fbr/yumFeTzXwxIHnEs462JLFToUyJ7yCOdeDFmP20=
+  private key: (hidden)
+  listening port: 342
+
+peer: R4A01RXXqRJSY9TiKQrZGR85HsFNSXxhRKKEu/bEdTQ=
+  endpoint: 168.119.114.183:342
+  allowed ips: 10.1.2.9/32
+  latest handshake: 57 seconds ago
+  transfer: 1003.48 KiB received, 185.89 KiB sent
+  persistent keepalive: every 1 minute
+```
-- 
cgit v1.2.3