<a id="how-to"></a>

# How-to guides

Operate the WireGuard gateway charm across its lifecycle, from shaping the VPN routing, redundancy, and throughput of a freshly deployed gateway to keeping an established deployment observable and up to date. Each guide assumes that you have already deployed the charm with Juju.

## Networking and VPN configuration

A WireGuard gateway’s core behavior is defined by charm configuration options that control which networks it routes to, how it fails over, and how much traffic it can sustain. Setting these correctly turns a deployed unit into a working, resilient tunnel endpoint.

* [Set up a site-to-site VPN](https://canonical.com/juju/docs/wireguard-gateway-charm/latest/how-to/setup-site-to-site-vpn/index.html.md#how-to-setup-site-to-site-vpn)
* [Enable VRRP](https://canonical.com/juju/docs/wireguard-gateway-charm/latest/how-to/enable-vrrp/index.html.md#how-to-enable-vrrp)
* [Tune performance on multi-core CPUs](https://canonical.com/juju/docs/wireguard-gateway-charm/latest/how-to/performance-tuning/index.html.md#how-to-performance-tuning)

## Operations and maintenance

Once a gateway is carrying traffic, keeping it healthy means watching its behavior, recovering lost units, adopting new revisions without interrupting service, and improving the guides that describe these tasks.

* [Integrate with COS](https://canonical.com/juju/docs/wireguard-gateway-charm/latest/how-to/integrate-with-cos/index.html.md#how-to-integrate-with-cos)
* [Back up and restore](https://canonical.com/juju/docs/wireguard-gateway-charm/latest/how-to/back-up-restore/index.html.md#how-to-back-up-restore)
* [Upgrade](https://canonical.com/juju/docs/wireguard-gateway-charm/latest/how-to/upgrade/index.html.md#how-to-upgrade)
* [Contribute](https://canonical.com/juju/docs/wireguard-gateway-charm/latest/how-to/contribute/index.html.md#how-to-contribute)
