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 every enabled 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: Get MoaV running in 5 steps
- 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
Using MoaV¶
- Client Apps: Connect from iOS, Android, macOS, Windows, Linux
- MoaV Client: Self-hosted client with a dashboard, load-balancing, and automatic failover
- CLI Reference: All
moavcommands 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+ protocols with descriptions and links
Developer¶
- Development & Testing: repo layout, test/e2e coverage, self-hosted runner setup, and the contributor/agent checklists