Skip to content

Video tutorials

Community-made walkthroughs of installing and running MoaV.

No English tutorial yet — one in Farsi

Switch the language in the top bar (فارسی) for a full server walkthrough by @iaghapour.

Made one, or thinking about it? The fastest way in is the ✏️ edit button in the corner of this page — it opens this file straight in GitHub, so you can add your video and send a PR without cloning anything. Or just open an issue with the link and we will add it.

A recording of a real install is worth more than any amount of prose, and it finds bugs the maintainers never hit — several fixes in 2.1.0 came from watching the Farsi one. Credit stays with the author; we link rather than re-host. (The docs live in moav-site, separate from the main MoaV repo.)

Prefer reading? Quick Start is the same path in about ten minutes.

What a good tutorial covers

Roughly the order a new operator needs. Nobody has to cover all of it — one clear piece is useful on its own.

Getting a server running

  1. A VPS and a domain pointed at it — VPS Deployment, DNS Configuration
  2. The one-command install, and what moav bootstrap asks for
  3. Running it at home instead: a Raspberry Pi or spare box, checking for CGNAT first, forwarding the ports — Home server / Raspberry Pi

Getting people connected

  1. Creating a user and sending them their bundle — moav user add NAME --package
  2. Connecting from a phone: importing a config, and which app suits which protocol — Client Apps
  3. Choosing between protocols, and what to do when one is blocked — Supported Protocols, then moav doctor

Going further

  1. The MoaV client — running moav-client on a desktop so several protocols are probed and the fastest live one is used automatically, rather than switching by hand
  2. Routing rules and plugins, which is where it stops being only a VPN. Send local and national sites direct so banking and government portals still work and your exit bandwidth is not wasted; block ad and tracker domains for every device on the tunnel; block torrent traffic on a donated server. The client's rule engine is hot-swappable, so this is a satisfying thing to demo live.
  3. The admin dashboard and Grafana — adding users from a browser, and watching per-protocol throughput and per-user traffic: admin commands, Monitoring