MotherofallVPNs/MoaV v2.3.0-rc.1

v2.3.0-rc.1 — EXPERIMENTAL, not for production use

on GitHub

⚠️ Prerelease for testing — not for production. Stable moav update will not pull this; install it explicitly (below).

What's being tested

• sing-box → 1.14.0 (all pins). The images rebuild — this RC is the first real-world check that every protocol still passes traffic on 1.14.
• Snell — new protocol, ON by default. Lightweight TCP proxy, HTTP obfs, no TLS/domain. Shared-key (one PSK for all users, like the DNS tunnels), so revoking a user needs a key rotation + re-issue. Needs a Snell v5 client — Surge 5 / Stash / Clash Mi / Mihomo / Clash Meta for Android / FlClash (not v2rayNG/Hiddify).
• Hysteria2 gecko obfuscation (opt-in, HYSTERIA2_OBFS_TYPE=gecko).
• moav update fix: the Discard option now git reset --hards, so staged local changes no longer block the pull.
• Rolls up everything in 2.2.4 (bulk revoke, donation resume, Claude automation, component bumps: wstunnel 10.7.1, TrustTunnel 1.1.0, telemt 3.5.5, AmneziaWG-go, Prometheus 3.14.0).

Install / upgrade for testing

# fresh install on a throwaway server:
curl -fsSL moav.sh/install.sh | bash -s -- -b v2.3.0-rc.1
# or upgrade an existing test box (also exercises the update fix):
moav update -b v2.3.0-rc.1 && moav build && moav start
moav doctor && moav test <user>

Please report

sing-box image build failures, any protocol that fails moav test, Snell connection issues (v5 clients), or update problems.

Full changelog: v2.2.4...v2.3.0-rc.1

Note: the install command below fetches the latest stable release, not
this candidate. To try this build specifically, use the git checkout steps in
the notes above.

Quick Install

curl -fsSL https://moav.sh/install.sh | bash

This will install MoaV to /opt/moav and guide you through setup.

Documentation

moav.sh/docs — full documentation

Get started

• Quick Start — install to first user in ~10 minutes
• Client Setup — connect from phones and desktops
• DNS Configuration — records, delegations, freeing port 53

Reference

• CLI Reference — every command and flag
• Setup Guide — every option, in depth
• Monitoring — Grafana dashboards and metrics
• Troubleshooting — symptom-first fixes

Understand it

• Supported Protocols — per-protocol ports, ciphers, stealth
• Architecture — container topology and bundle flow
• Threat Model — what is and is not protected
• OPSEC Guide — operator-side hardening

Help out

• Support MoaV — run a server, contribute, translate, donate
• Translating the Docs — one page is a complete contribution

Running it with an AI agent? llms.txt is a compact
orientation for coding agents; llms-full.txt is the
whole corpus. Both ship as release assets.

Community

Telegram · X · Issues · moav.sh