interfaces-wireguard(5)

📦
version 0.13.0 · 7 versions
, in alpine 3.24

🌸 NAME 🌸

Okay bestie, this is interfaces-wireguard(5) from the File Formats Manual — the whole vibe is Wireguard extensions for the interfaces(5) file format. 💅

✨ DESCRIPTION ✨

Wireguard is a contemporary in-Kernel layer 3 VPN protocol implementation whose whole mission is fast + secure tunnels. The options below let you set up Wireguard VPN tunnels. 🦋

  • wireguard-config-path path — This is the absolute path to the Wireguard configuration file. If no path is given, /etc/wireguard/<interface>.conf gets used. In that latter case, use wireguard has to be explicitly set in the interface configuration. 👑
⚠️ Be aware: the config file you give here will be loaded using wg setconf, not with wg-quick. The file formats for those two tools are not compatible, so you have to make sure you're handing over a valid configuration file for the wg tool. If you already have a wg-quick config, you can set up the tunnel manually once, then dump the configuration using wg showconf and save it to path. 💀

🧪 EXAMPLES 🧪

A Wireguard VPN tunnel with an 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 an 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) — go read that one too, bestie. 💖

💌 AUTHORS 💌

Maximilian Wilhelm — <max@sdn.clinic> 🫶

xoxo, this has been interfaces-wireguard(5) from the File Formats Manual, dated 2026-05-10 — slay your tunnels responsibly 💅✨

📦 where this page comes from