zeq.dev / vpn / install

Install Zeq VPN client

macOSLinux — Phase 3Windows — Phase 3Mobile — Phase 4

macOS — manual build (Phase 2)

Code-signing the system extension for App-Store-style distribution requires an Apple Developer ID and is a Phase 3 release-engineering concern. Until then, build locally and run with sudo.

git clone https://github.com/zeq-os/zeq-framework
cd zeq-framework/app/packages/zeq-vpn-client-macos
cargo build --release
sudo install -m 755 target/release/zeq-vpn-client /usr/local/bin/

Stash your zsm_ bearer in Keychain

security add-generic-password \
  -a zeq.vpn.<your-slug> \
  -s "zeq-vpn-bearer" \
  -w "zsm_..." \
  -U

Write ~/.zeq/vpn/config.toml

mkdir -p ~/.zeq/vpn
cat > ~/.zeq/vpn/config.toml <<EOF
api_base       = "https://zeq.dev.local:3099"
machine_slug   = "<your-slug>"
zsm_keychain   = "zeq.vpn.<your-slug>"
cover_traffic_default = false
multi_hop_default     = false
kill_switch_on_drop   = true
dns_via_peer          = true
EOF

Brew (Phase 3 — code-signing required)

soon brew tap zeq-os/vpn
soon brew install zeq-vpn

Use it

zeq-vpn-client marketplace --country EU --max-zeq-per-gb 100
zeq-vpn-client connect --peer-slug zeq07000000007 --lifespan-zeqonds 500 --pricing-unit gb
zeq-vpn-client accept --tunnel-id <uuid>
zeq-vpn-client terminate --tunnel-id <uuid> --cumulative-bytes 1234 --cumulative-zeqonds 500
zeq-vpn-client tunnels