---
name: "interfaces-wireguard"
section: "5"
platform: "linux"
package: "ifupdown-ng"
version: "0.12.1-7"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/interfaces-wireguard"
---

# interfaces-wireguard(5)

Wireguard extensions for the interfaces(5) file format

## NAME

**interfaces-wireguard** - Wireguard extensions for the [interfaces(5)](/interfaces/5.md) 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)](/interfaces-wireguard-quick/5.md)

## AUTHORS

Maximilian Wilhelm \<max@sdn.clinic\>