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.
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
- Open the local agent UI: http://127.0.0.1:9191
- Set PME Server URL to https://pme.pmenetwork.com
- Sign in with your PME account → Register with PME Server
- Confirm relay shows connected (30-day trial or Mesh Pro; requires PME_RELAY_ENABLED=true)
- Create your first invite — set which LAN IPs or subnets that phone or laptop may reach
Requirements
- Always-on home machine on your LAN
- Hardware & network requirements
- Getting Started
- Troubleshooting — install