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 Assume that outgoing GoVPN packets can be fragmented, so we do not
12 bother configuring MTU of TAP interfaces. For better performance just
13 lower it and check that no fragmentation of outgoing UDP packets occurs.
16 @strong{Install}. At first you must @ref{Installation, install} this
17 software: download, @ref{Integrity, check the signature}, compile.
19 @strong{Prepare the client}. Generate client's verifier for Alice as an
23 client% ./utils/newclient.sh Alice
25 Your client verifier is: $argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg
27 Place the following YAML configuration entry on the server's side:
31 iface: or TAP interface name
32 verifier: $argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg$KCNIqfS4DGsBTtVytamAzcISgrlEWvNxan1UfBrFu10
34 Verifier was generated with:
36 ./utils/storekey.sh /tmp/passphrase
37 govpn-verifier -key /tmp/passphrase
40 @strong{Prepare the server}. Add this entry to @code{peers.yaml}
46 verifier: $argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg$KCNIqfS4DGsBTtVytamAzcISgrlEWvNxan1UfBrFu10
49 @strong{Prepare network on GNU/Linux IPv4 server}:
53 server% ip addr add 192.168.0.1/24 dev wlan0
54 server% tunctl -t tap10
55 server% ip addr add 172.16.0.1/24 dev tap10
56 server% ip link set up dev tap10
59 @strong{Run server daemon itself}:
62 server% govpn-server -bind 192.168.0.1:1194
65 @strong{Prepare network on GNU/Linux IPv4 client}:
69 client% utils/storekey.sh key.txt
70 client% ip addr add 192.168.0.2/24 dev wlan0
71 client% tunctl -t tap10
72 client% ip addr add 172.16.0.2/24 dev tap10
73 client% ip link set up dev tap10
74 client% ip route add default via 172.16.0.1
77 @strong{Run client daemon itself}:
79 client% govpn-client \
81 -verifier '$argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg' \
83 -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 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