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-08-02                    interfaces-wireguard(5)