4 Let's assume that there is some insecure link between your computer and
5 WiFi-reachable gateway.
8 @item You have got @code{wlan0} NIC with 192.168.0/24 network on it.
9 @item You want to create virtual encrypted and authenticated 172.16.0/24
10 network and use it as a default transport.
11 @item @code{wlan0} MTU is 1500, 20 bytes overhead per IPv4. So MTU for
12 GoVPN is 1500 - 20 - 8 = 1472.
13 @item During startup client and server will say that TAP interface MTU
17 @strong{Install}. At first you must @ref{Installation, install} this
18 software: download, @ref{Integrity, check the signature}, compile.
20 @strong{Prepare the client}. Generate client's verifier for Alice as an
24 client% ./utils/newclient.sh Alice
26 Your client verifier is: $argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg
28 Place the following JSON configuration entry on the server's side:
31 "up": "/path/to/up.sh",
32 "verifier": "$argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg$KCNIqfS4DGsBTtVytamAzcISgrlEWvNxan1UfBrFu10"
35 Verifier was generated with:
37 ./utils/storekey.sh /tmp/passphrase
38 govpn-verifier -key /tmp/passphrase
41 @strong{Prepare the server}. Add this entry to @code{peers.json}
44 @strong{Prepare network on GNU/Linux IPv4 server}:
48 server% echo "#!/bin/sh" > /path/to/up.sh
49 server% echo "echo tap10" >> /path/to/up.sh
50 server% ip addr add 192.168.0.1/24 dev wlan0
51 server% tunctl -t tap10
52 server% ip link set mtu 1432 dev tap10
53 server% ip addr add 172.16.0.1/24 dev tap10
54 server% ip link set up dev tap10
57 @strong{Run server daemon itself}:
60 server% govpn-server -bind 192.168.0.1:1194 -mtu 1472
63 @strong{Prepare network on GNU/Linux IPv4 client}:
67 client% utils/storekey.sh key.txt
68 client% ip addr add 192.168.0.2/24 dev wlan0
69 client% tunctl -t tap10
70 client% ip link set mtu 1432 dev tap10
71 client% ip addr add 172.16.0.2/24 dev tap10
72 client% ip link set up dev tap10
73 client% ip route add default via 172.16.0.1
76 @strong{Run client daemon itself}:
78 client% govpn-client \
80 -verifier '$argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg' \
82 -remote 192.168.0.1:1194 \
86 @strong{FreeBSD IPv6 similar client-server example}:
89 server% ifconfig em0 inet6 fe80::1/64
90 server% govpn-server -bind "fe80::1%em0"
94 client% ifconfig me0 inet6 -ifdisabled auto_linklocal
95 client% ifconfig tap10
96 client% ifconfig tap10 inet6 fc00::2/96 mtu 1412 up
97 client% route -6 add default fc00::1
98 client% govpn-client \
100 -verifier '$argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg' \
102 -remote "[fe80::1%me0]":1194