NAME

       interfaces-wireguard - Wireguard extensions for the interfaces(5) file format

DESCRIPTION

       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.

WIREGUARD-RELATED OPTIONS

       wireguard-config-path path
           Denotes the absolute path to the Wireguard configuration file. If no path is given,
           /etc/wireguard/<interface>.conf will be used. In the latter case use wireguard has to be explicitly
           set to the interface configuration.

           Be aware that the given configuration file will be loaded using wg setconf and not with wg-quick.
           The file format for both tools isn't compatible so you have to make sure you provide a valid
           configuration file for the wg tool.  If you already have a configuration file for wg-quick you can
           set up the tunnel manually once and then dump the configuration using wg showconf and save this to
           path.

EXAMPLES

       A Wireguard VPN tunnel with explicit configuration file specified

           auto wg-foo
           iface wg-foo
                wireguard-config-path /etc/wireguard/foo.conf
                #
                address 192.0.2.23/42
                address 2001:db8::23/64

       A Wireguard VPN tunnel with implicit configuration file:

           auto wg-bar
           iface wg-bar
                use wireguard
                #
                address 192.0.2.23/42
                address 2001:db8::23/64

SEE ALSO

       interfaces-wireguard-quick(5)

AUTHORS

       Maximilian Wilhelm <max@sdn.clinic>

                                                   2024-03-13                            interfaces-wireguard(5)