MoaV Documentation¶

MoaV (Mother of all VPNs) is a free, open-source multi-protocol censorship circumvention stack. Deploy a full arsenal of anti-censorship protocols on any VPS or home server with a single command.

MoaV generates ready-to-use client bundles for each user, containing config files, QR codes, and step-by-step instructions (in English and Farsi) for each enabled and successfully configured user-facing protocol. Non-technical users simply open the bundle's README.html in their browser, scan a QR code, and connect. No manual configuration needed.

Read the concise Mission, the project's Impact model, and the public Threat Model.

New here? Start with the Quick Start Guide to get up and running in minutes.

Guides¶

Quick Start: Install, create a user, and share a bundle
Setup Guide: Complete installation with all options
DNS Configuration: DNS records for your domain and provider
VPS Deployment: One-click deploy on Hetzner, DigitalOcean, Vultr, Linode
Video Tutorials: Video Walkthroughs

Using MoaV¶

Client Apps: Connect from iOS, Android, macOS, Windows, Linux
MoaV Client: MoaV client with a dashboard, load-balancing, and automatic failover
CLI Reference: All moav commands and options
Monitoring: Grafana + Prometheus dashboards
Troubleshooting: Common issues and fixes

Security & Philosophy¶

Mission: What MoaV is, who it serves, and how to help
Impact: Theory of change, outcomes, and measurable progress
Threat Model: Honest limits, adversaries, metadata risks, and safety assumptions
OPSEC Guide: Security best practices for operators
Mission & Philosophy: The longer manifesto behind the project
Supported Protocols: All 16+ circumvention transports and fallback paths, plus optional Psiphon, Tor and MahsaNet donation integrations, including the DNS tunnels that can remain usable where ordinary traffic is blocked but recursive DNS still resolves

Support the project¶

Support MoaV: Run a server, donate bandwidth, contribute code, translate, or fund the infrastructure

Developer¶

Development & Testing: installing from a branch or tag, repo layout, how CI and the end-to-end suite work, and how to contribute