MEschenbacher's Wireguard Saltstack Formula
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Maximilian Eschenbacher f57911516d update README 6 years ago
_modules Import 6 years ago
_states Import 6 years ago
wireguard Import 6 years ago
README.md update README 6 years ago
pillar.example Import 6 years ago

README.md

wireguard-formula

Installs WireGuard (usually dkms and utils), and creates interfaces plus peers.

See the full Salt Formulas installation and usage instructions.

Configuration

All configuration is done via pillar data. See pillar.example for examples.

Available states

wg.present (name, listen_port, fwmark, private_key, preshared_key)

Creates a wireguard interface and sets interface-wide parameters.

wg.peer_present (name, interface, endpoint, persistent_keepalive, allowed_ips)

Adds a peer to an interface and sets peer-specific parameters.

wg.absent (name)

Removes a wireguard interface.

wg.peer_absent (name, interface)

Removes a peer from an interface.

Excerpt of a few available module functions

salt-call wg.create wgtest

salt-call wg.show wgtest

salt-call wg.set interface listen_port=1337

salt-call wg.delete wgtest