> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WireGuard Peer Config on macOS

> Configure a macOS device as a WireGuard peer to connect to a Telnyx WireGuard Gateway. Set up keys, peer endpoints, and the WireGuard macOS app.

## Prerequisite

You come from [here](https://developers.telnyx.com/docs/network/gateways/wireguard-gateway) and have a `.conf` file ready.

## Step 1: Install WireGuard Client

From [here](https://www.wireguard.com/install/), choose and install the macOS client.

## Step 2: Create a Tunnel

"Import Tunnel(s) from File..."

<img src="https://mintcdn.com/telnyx/d2AUJO5qdne_WnZI/img/create-tunnel.png?fit=max&auto=format&n=d2AUJO5qdne_WnZI&q=85&s=01f8c04453399af1e7671b9aabd5d706" alt="Import Tunnel(s) from File..." width="602" height="254" data-path="img/create-tunnel.png" />

"Activate"

<img src="https://mintcdn.com/telnyx/qRGzozfyAtvPtPCw/img/activate.png?fit=max&auto=format&n=qRGzozfyAtvPtPCw&q=85&s=507ad61da1c474f140310b026133a524" alt="&#x22;Activate&#x22;" width="1578" height="1070" data-path="img/activate.png" />

At this point, it should show "Status: Active"

<img src="https://mintcdn.com/telnyx/qRGzozfyAtvPtPCw/img/activate-success.png?fit=max&auto=format&n=qRGzozfyAtvPtPCw&q=85&s=3b82c9d8d4dafe5af12ad0ec85baefb4" alt="&#x22;Active&#x22;" width="1572" height="1060" data-path="img/activate-success.png" />

## Step 3: Validating and Testing

A connected peer should be pingable.

```
user@macbook-pro wireguard % ping 172.27.0.3
PING 172.27.0.3 (172.27.0.3): 56 data bytes
64 bytes from 172.27.0.3: icmp_seq=0 ttl=63 time=35.006 ms
64 bytes from 172.27.0.3: icmp_seq=1 ttl=63 time=32.528 ms
64 bytes from 172.27.0.3: icmp_seq=2 ttl=63 time=33.376 ms
^C
--- 172.27.0.3 ping statistics ---
3 packets transmitted, 3 packets received, 0.0% packet loss
round-trip min/avg/max/stddev = 32.528/33.637/35.006/1.028 ms
```

## Next Steps

[WireGuard Gateway (WGW) Guide](https://developers.telnyx.com/docs/network/gateways/wireguard-gateway) outlines many use cases that may be valuable to you.