/ QUICKSTART

Get your first machine online in 2 minutes.

Three simple steps to create the mesh, plus vendor-specific instructions for whatever hardware you have.

No credit card
Under 2 minutes
Works with your hardware

A private network,
ready in minutes.

Connect your devices securely
and start building your mesh.

01 ~ 30 seconds

Sign up

Create your account with Google or email. No credit card. You'll land in the dashboard in under a minute.

02 ~ 1 minute

Add a machine

Click Add machine, give it a name (e.g. "branch-mumbai" or "office-router"), and we generate a WireGuard config tied to that machine.

03 ~ 30 seconds

Paste the config into your device

Open the WireGuard section of your router or the official WireGuard app on your laptop / phone. Paste the config. The tunnel comes up within seconds.

TP

TP-Link

Archer · Deco · ER series with WireGuard support.

  1. Open the router's admin UI (typically http://192.168.0.1)
  2. Go to Advanced → VPN Server → WireGuard
  3. Click Add, paste the [Interface] + [Peer] config from your MeshWG dashboard
  4. Save & Enable
MI

MikroTik

RouterOS 7+. WireGuard is a first-class interface type.

  1. Open WinBox or the WebFig admin
  2. Go to WireGuard → + (Add) and create the interface
  3. Add a Peer with the public key, endpoint, and allowed-IPs from MeshWG
  4. Add an IP address on the WireGuard interface (your machine's overlay IP)
OP

OpenWrt

19.07+ via LuCI or /etc/config/network. Wraps wg-quick.

  1. Install: opkg update && opkg install wireguard-tools luci-app-wireguard luci-proto-wireguard
  2. LuCI → Network → Interfaces → Add new interface (Protocol: WireGuard VPN)
  3. Paste the keys, endpoint, and allowed-IPs from MeshWG
  4. Save & Apply
UB

Ubiquiti

UDM (firmware 3.x+) and EdgeRouter with the wireguard package.

  1. UDM: Settings → Teleport & VPN → VPN Client → WireGuard, import the config
  2. EdgeRouter: install the wireguard .deb, configure via `configure` mode
  3. Reference the public key, endpoint, and allowed-IPs from MeshWG
  4. Commit; save
OP

OPNsense / pfSense

OPNsense 22.1+ has WireGuard in core. pfSense 2.7+ as a package.

  1. VPN → WireGuard → Instances → Add
  2. Paste keys + tunnel address from MeshWG
  3. Add a Peer with public key, endpoint, allowed-IPs
  4. Enable; assign the interface; firewall rule to allow
LI

Linux / Mac / Windows / mobile

Use the official WireGuard app — it imports the .conf as-is.

  1. Install the official WireGuard client from wireguard.com/install/
  2. Click Import tunnel(s) from file
  3. Pick the .conf file MeshWG generated for this machine
  4. Activate the tunnel

Everything you need to build a mesh network — under one control plane

Prerequisites, architecture, site-to-site connectivity, verification, and troubleshooting — all the context you need to configure your WireGuard routers seamlessly.

What You Need

  • Supported Router or Device: A router from our compatibility hub (TP-Link, MikroTik, Ubiquiti, etc.) or a device running the official WireGuard client.
  • Internet Connection: Basic outbound internet access. You do not need a static IP, port forwarding, or DDNS on your clients.
  • MeshWG Account: A free MeshWG account to orchestrate the network.

How MeshWG Works

MeshWG operates as a hosted control plane for standard WireGuard. When you add a machine to your dashboard, MeshWG generates a WireGuard configuration. The private keys are returned once and are never retained server-side. MeshWG orchestrates the peer connections (endpoint IPs and routing tables) across your network. Your actual encrypted traffic is designed to flow directly peer-to-peer between your routers, utilizing relays only when direct UDP connections are blocked.

Connecting Locations (Site-to-Site)

To connect two branch offices (e.g., sharing a subnet like 192.168.10.0/24), you do not need complex manual routing. In the dashboard, edit the machine representing your router and add its local subnet to its Advertised Routes. MeshWG will automatically update the AllowedIPs on all other authorized peers in your network to route traffic seamlessly.

Verification

Once you apply the WireGuard configuration to your device, verify the tunnel is active:

  1. Check Dashboard Status: Verify the machine's "Last Seen" status updates to Just now in the MeshWG dashboard.
  2. Test Overlay IP: Ping the machine's assigned Overlay IP (e.g., 10.x.x.x) from another connected device on the mesh.
  3. Test Site-to-Site: If you configured Advertised Routes, ping a device on the remote LAN subnet from a local device.

Troubleshooting

If your tunnel fails to establish a handshake or pass traffic, check these common issues:

  1. CGNAT or Strict Firewalls: WireGuard requires UDP traffic. MeshWG utilizes STUN-assisted UDP hole punching to traverse CGNAT, but persistent handshake failures often indicate blocked UDP traffic. Verify your firewall allows outbound UDP on the WireGuard port.
  2. MTU Clipping: If the tunnel establishes but websites fail to load or SSH sessions freeze, your MTU is likely too high. Try lowering the WireGuard interface MTU from the default 1420 to 1360 or 1280.

Security Considerations

MeshWG is built around standard WireGuard cryptography. Private keys generated during setup are shown to you once and are not persisted server-side. Additionally, MeshWG employs a Zero Trust access model—machines cannot communicate with each other by default unless you explicitly create an Access Rule allowing the connection. Learn more in our technical documentation.

SUPPORT We typically respond within a few hours

Email us. We answer fast.

Most setups land in under 2 minutes. If yours doesn't, send a note with your router model and we'll walk it through with you — usually same day.