@node Example
-@cindex Example
-@cindex Example usage
-@cindex Tutorial
@section Example usage
Let's assume that there is some insecure link between your computer and
@strong{Prepare the client}. Generate client's verifier for Alice as an
example:
-@cindex newclient.sh
@verbatim
client% ./utils/newclient.sh Alice
-Enter passphrase:
+Passphrase:
Your client verifier is: $argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg
Place the following YAML configuration entry on the server's side:
up: /path/to/up.sh
iface: or TAP interface name
verifier: $argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg$KCNIqfS4DGsBTtVytamAzcISgrlEWvNxan1UfBrFu10
-
-Verifier was generated with:
-
- ./utils/storekey.sh /tmp/passphrase
- govpn-verifier -key /tmp/passphrase
@end verbatim
-@strong{Prepare the server}. Add this entry to @code{peers.yaml}
+@strong{Prepare the server}. Add this entry to @file{peers.yaml}
configuration file:
@verbatim
@strong{Prepare network on GNU/Linux IPv4 server}:
-@example
-server% umask 077
+@verbatim
server% ip addr add 192.168.0.1/24 dev wlan0
server% tunctl -t tap10
server% ip addr add 172.16.0.1/24 dev tap10
server% ip link set up dev tap10
-@end example
+@end verbatim
@strong{Run server daemon itself}:
-@example
+@verbatim
server% govpn-server -bind 192.168.0.1:1194
-@end example
+@end verbatim
@strong{Prepare network on GNU/Linux IPv4 client}:
-@example
-client% umask 066
-client% utils/storekey.sh key.txt
+@verbatim
client% ip addr add 192.168.0.2/24 dev wlan0
client% tunctl -t tap10
client% ip addr add 172.16.0.2/24 dev tap10
client% ip link set up dev tap10
client% ip route add default via 172.16.0.1
-@end example
+@end verbatim
@strong{Run client daemon itself}:
-@example
+@verbatim
client% govpn-client \
- -key key.txt \
-verifier '$argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg' \
-iface tap10 \
-remote 192.168.0.1:1194
-@end example
+@end verbatim
@strong{FreeBSD IPv6 similar client-server example}:
-@example
+@verbatim
server% ifconfig em0 inet6 fe80::1/64
server% govpn-server -bind "fe80::1%em0"
-@end example
+@end verbatim
-@example
+@verbatim
client% ifconfig me0 inet6 -ifdisabled auto_linklocal
client% ifconfig tap10
client% ifconfig tap10 inet6 fc00::2/96 up
client% route -6 add default fc00::1
client% govpn-client \
- -key key.txt \
-verifier '$argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg' \
-iface tap10 \
-remote "[fe80::1%me0]":1194
-@end example
+@end verbatim