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

# WireGuard on macOS

> Connect to a TunnelFleet WireGuard server from macOS.

<Steps>
  <Step title="Download your config">
    In TunnelFleet, open the server → **Users** → download the WireGuard `.conf`, or keep the QR code handy for mobile handoff.
  </Step>

  <Step title="Install WireGuard">
    Install **WireGuard** from the [Mac App Store](https://apps.apple.com/app/wireguard/id1451685025).
  </Step>

  <Step title="Import">
    Open WireGuard → **Import tunnel(s) from file…** and select the `.conf` file.
  </Step>

  <Step title="Connect">
    Toggle the tunnel **On**. Approve the VPN configuration permission prompt if macOS asks.
  </Step>
</Steps>

## Verify

Browse to [ifconfig.me](https://ifconfig.me) and confirm the public IP is your VPS.

## Tips

* Enable **On-Demand** only if you understand the network rules — start with manual connect
* Store configs outside Downloads if you sync that folder to untrusted machines
* On Apple silicon and Intel Macs, use the official App Store build

## Troubleshooting

| Issue             | Fix                                                                    |
| ----------------- | ---------------------------------------------------------------------- |
| Permission denied | Approve VPN creation in System Settings → Privacy & Security           |
| Handshake timeout | Confirm UDP 51820 is open on the server and not blocked on the network |
| DNS issues        | Re-download the profile from TunnelFleet and re-import                 |