The project's README from github.com/armanlife/arman-vpn-client. As one markdown file: README.md.
🇺🇸 English / 🇨🇳 简体中文 / 🇷🇺 Русский / 🇮🇷 فارسی

Firefox VPN is a free, open-source VPN that works with a Firefox Account. It carries your internet traffic through Mozilla's servers, on Fastly's infrastructure, over secure HTTP/2 and HTTP/3 tunnels.
Every Firefox Account comes with 50 GB of free data a month, and the multi-account feature multiplies it: when one runs out, the next connects automatically.
For Android, Windows, macOS, and Linux; completely free, with no ads.
✈️ Cross-platform: Android, Windows, macOS, and Linux
📺 Android TV: works with the remote control
⭐ Very easy to use, with a simple interface
🆓 Free: 50 GB a month for every Firefox Account
➕ Multi-account: when one account's data runs out, the next takes over automatically
🌐 Mozilla's official servers: choose a country with a ping test, or let the app pick the best server
⚡ Fast, stable connections over HTTP/2 and HTTP/3
🔀 Smart routing (split tunneling): choose the sites and apps that skip the VPN
🧱 If Mozilla is blocked: TLS fragmentation, upstream SOCKS5 proxy, and a relay server
🔒 Encrypted DNS (DNS over HTTPS)
🌍 15 languages, including English, Persian, Chinese, and Russian
🌙 Light and dark themes
🛡 Open source, secure, and community-driven
🔄 Automatic updates
| System | Download |
|---|---|
| Android | |
| Android TV | |
| Windows | |
| macOS | |
| Linux | |
Which file should I download?
Windows and Android users don't need this section: take the installer from the "Download" table above.
curl -fsSL https://raw.githubusercontent.com/armanlife/firefox-vpn-client/main/install.sh | bash
For Linux servers, Firefox VPN has a web panel that opens in any browser and has everything the app has: managing accounts and data, choosing a server and testing delay, the connection test, the live log, and every setting.

http://SERVER-IP:10820/app/, with a username and password. The exact address is shown at the end of the install.10810, with a username and password of its own.On the server, run sudo firefox-vpn to open the management menu:
$ sudo firefox-vpn
Firefox VPN
────────────────────────────────────────────────────────────────────────────
Service ● running
Autostart on
────────────────────────────────────────────────────────────────────────────
0) Exit
────────────────────────────────────────────────────────────────────────────
1) Update firefox-vpn update
2) Uninstall firefox-vpn uninstall
────────────────────────────────────────────────────────────────────────────
3) Set panel login firefox-vpn panel
4) View panel info firefox-vpn panel-info
────────────────────────────────────────────────────────────────────────────
5) Status firefox-vpn status
6) Start firefox-vpn start
7) Stop firefox-vpn stop
8) Restart firefox-vpn restart
9) Show the log firefox-vpn logs
────────────────────────────────────────────────────────────────────────────
10) Enable autostart firefox-vpn enable
11) Disable autostart firefox-vpn disable
────────────────────────────────────────────────────────────────────────────
12) Add a Firefox Account firefox-vpn add-account
13) List the accounts firefox-vpn list-accounts
────────────────────────────────────────────────────────────────────────────
Enter a number [0-13]:
To install on an OpenWrt router, see the OpenWrt guide.