.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "interfaces-wireguard" "5" "2024-05-06"
.PP
.SH NAME
.PP
\fBinterfaces-wireguard\fR - Wireguard extensions for the interfaces(5) file format
.PP
.SH DESCRIPTION
.PP
Wireguard is a comtemporary in-Kernel layer 3 VPN protocol implementation
which aims to provide fast and secure tunnels.\& The following options
allow to set up Wireguard VPN tunnels.\&
.PP
.SH WIREGUARD-RELATED OPTIONS
.PP
\fBwireguard-config-path\fR \fIpath\fR
.RS 4
Denotes the absolute \fIpath\fR to the Wireguard configuration file.\&
If no path is given, \fI/etc/wireguard/<interface>.\&conf\fR will be
used.\& In the latter case \fIuse wireguard\fR has to be explicitly
set to the interface configuration.\&
.PP
Be aware that the given configuration file will be loaded using
\fBwg setconf\fR and not with \fBwg-quick\fR.\&  The file format for both
tools isn'\&t compatible so you have to make sure you provide a
valid configuration file for the \fBwg\fR tool.\&  If you already have
a configuration file for \fBwg-quick\fR you can set up the tunnel
manually once and then dump the configuration using \fBwg showconf\fR
and save this to \fIpath\fR.\&
.PP
.PP
.RE
.SH EXAMPLES
.PP
A Wireguard VPN tunnel with explicit configuration file specified
.PP
.nf
.RS 4
auto wg-foo
iface wg-foo
	wireguard-config-path /etc/wireguard/foo\&.conf
	#
	address 192\&.0\&.2\&.23/42
	address 2001:db8::23/64
.fi
.RE
.PP
A Wireguard VPN tunnel with implicit configuration file:
.PP
.nf
.RS 4
auto wg-bar
iface wg-bar
	use wireguard
	#
	address 192\&.0\&.2\&.23/42
	address 2001:db8::23/64
.fi
.RE
.PP
.SH SEE ALSO
.PP
\fBinterfaces-wireguard-quick\fR(5)
.PP
.SH AUTHORS
.PP
Maximilian Wilhelm <max@sdn.\&clinic>