Checking sign-in…

Download PME Edge

One binary: PME agent UI, WireGuard VPN server, and invite provisioning. Runs on the machine that stays on your LAN (Mac mini, NUC, desktop PC, etc.).

Releases

Pre-built archives are published on ws-edge releases. Asset names look like ws-edge_0.1.0_darwin_arm64.tar.gz or ws-edge_0.1.0_linux_amd64.tar.gz.

Download latest release

macOS

1. Prerequisites

brew install wireguard-tools dnsmasq

Apple Silicon → darwin_arm64. Intel → darwin_amd64.

2. Download and install

Download the matching archive from releases, then:

tar -xzf ws-edge_*_darwin_*.tar.gz
chmod +x edge
# If Gatekeeper blocks the binary:
xattr -d com.apple.quarantine edge 2>/dev/null || true
sudo mv edge /usr/local/bin/edge

Or use the helper script from install-edge.sh (./install-edge.sh -o /usr/local/bin).

3. One-time sudoers

Edge runs as your user and needs passwordless sudo for WireGuard, dnsmasq, and pf:

MAC_USER="$(whoami)"
WG="$(command -v wg)"
DNSMASQ="$(command -v dnsmasq)"
sudo tee /etc/sudoers.d/ws-edge <<EOF
${MAC_USER} ALL=(root) NOPASSWD: ${WG}, ${DNSMASQ}, /sbin/pfctl, /usr/sbin/sysctl, /bin/cp, /bin/kill, /sbin/route
EOF
sudo chmod 440 /etc/sudoers.d/ws-edge
sudo visudo -c -f /etc/sudoers.d/ws-edge

Full guide: docs/install/MACOS.md.

4. Run

export EDGE_DATA_DIR="$HOME/.edge"
export PME_RELAY_ENABLED=true
edge run

Open http://127.0.0.1:9191 — continue at After install.

Ubuntu / Linux

1. Prerequisites

sudo apt update
sudo apt install -y wireguard wireguard-tools dnsmasq nftables iptables curl

Ubuntu 24.04 LTS recommended. Note your LAN NIC (ip -br link) — often eth0 or enp*.

2. Download and install

tar -xzf ws-edge_*_linux_*.tar.gz
chmod +x edge
sudo mv edge /usr/local/bin/edge

Or: ./install-edge.sh -o /usr/local/bin (same helper as macOS).

3. Run

export EDGE_DATA_DIR="$HOME/.edge"
export PME_RELAY_ENABLED=true
export VPN_LAN_INTERFACE=eth0   # your NIC
edge run

For always-on hosts, install the systemd unit from the release archive (packaging/systemd/edge.service) and set env in /etc/default/edge. Details: docs/install/UBUNTU.md.

Open http://127.0.0.1:9191 — continue at After install.

Windows

Windows amd64 builds are published on the releases page. Maturity is behind macOS/Linux — check release notes before relying on Windows as your always-on host.

After install

  1. Open the local agent UI: http://127.0.0.1:9191
  2. Set PME Server URL to https://pme.pmenetwork.com
  3. Sign in with your PME account → Register with PME Server
  4. Confirm relay shows connected (30-day trial or Mesh Pro; requires PME_RELAY_ENABLED=true)
  5. Create your first invite — set which LAN IPs or subnets that phone or laptop may reach

Requirements