<a id="how-to-setup-site-to-site-vpn"></a>

# How to set up WireGuard gateway charm as a site-to-site VPN

The primary use case for the WireGuard gateway charm is to connect two or more
sites using a WireGuard VPN. The critical configuration for a site-to-site VPN
is the  `advertise-prefixes` option. This configuration of the
WireGuard gateway charm represents what network this WireGuard gateway unit is
adjacent to and knows how to route to.

For example, let’s say we have two sites that need to be
connected with the WireGuard gateway charm:

* Site A network has the IP address `10.0.0.0/8`.
* Site B has the network IP address `192.168.0.0/16`.

Then the WireGuard gateway charm deployed on site A should have an
`advertise-prefixes` value of `10.0.0.0/8`, and site B’s instance of the
WireGuard gateway charm should have an `advertise-prefixes` value of
`192.168.0.0/16`:

```default
juju config wireguard-site-a advertise-prefixes=10.0.0.0/8
juju config wireguard-site-b advertise-prefixes=192.168.0.0/16
```

Once the configurations are in place, the deployment setup will resemble the following diagram.

The `advertise-prefixes` configuration allows the WireGuard gateway
charm unit to inform other integrated WireGuard gateway charm deployments
about the prefixes the unit is responsible for. The other integrated deployments
know to send all relevant network traffic to the unit.
