arman-vpn-client README

The project's README from github.com/armanlife/arman-vpn-client. As one markdown file: README.md.

🇺🇸 English  /  🇨🇳 简体中文  /  🇷🇺 Русский  /  🇮🇷 فارسی


Firefox VPN

Firefox VPN

Downloads Last Version License

What is Firefox VPN?

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.

Firefox VPN

🚀 Main features

✈️ 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

📸 Screenshots

Home   Servers   Settings

📥 Download

SystemDownload
AndroidAPK Universal
APK ARMv8
APK ARMv7
APK x64
Android TVAPK Universal
WindowsSetup x64
Portable x64
macOSDMG Universal
LinuxApp amd64
App ARM64
Core amd64
Core ARM64

Which file should I download?

💻 Install and update on Linux and macOS

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

🌐 Web panel

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.

Web panel

⌨️ Managing from the terminal

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]:

OpenWrt routers

To install on an OpenWrt router, see the OpenWrt guide.

Known limitations

What Mozilla's servers do not carry
  • TCP: ports 80, 443, 8080, and 8443 only. Other ports, such as mail (25, 465, 587, 993) and SSH (22), are refused. Git over SSH to GitHub is the exception: it goes through port 443 by itself.
  • UDP: ports 80, 443, 3478, 8080, 8443, and 49152-65534 only. Calls and games on other ports do not go through. Browsers and most apps work normally.
  • Android notifications: Google's push service uses port 5228, so with the VPN on, some apps' notifications (WhatsApp, Telegram, and others) may arrive only when the app is opened.

arman-vpn-client (armanlife/arman-vpn-client)

Searching Database…

What is this?Firefox VPN is a free, open-source VPN client that tunnels your traffic through Mozilla's servers on Fastly's infrastructure using HTTP/2 and HTTP/3, authenticated with a Firefox Account.
How do I install it on my platform?Download the matching build from the project's Download table for Android, Windows, macOS, or Linux. On a Linux server without a graphical environment, install the 'Core' build, which sets up a web panel and a terminal menu you open with sudo firefox-vpn.
Do I need a Firefox Account to use it?Yes — every connection is tied to a Firefox Account, and each account comes with 50 GB of free data per month.
Does it support UDP traffic like voice calls and games?No. Mozilla's servers only carry TCP traffic over web ports (80, 443, 8080, 8443), so UDP-based calls, online games, and non-web ports like SSH or mail are blocked, except Git-over-SSH to GitHub which rides port 443 itself.
Where does my internet traffic actually go?All traffic is routed through Mozilla's official VPN servers running on Fastly's infrastructure over encrypted HTTP/2/HTTP/3, and DNS queries go through encrypted DNS over HTTPS.
What happens when one Firefox Account's monthly data runs out?The app automatically switches to the next linked Firefox Account, so the multi-account feature multiplies your monthly free data beyond the base 50 GB.
Can I manage the VPN without the app itself, like from a browser or terminal?On Linux server installs, a web panel lets you manage accounts, pick servers, run connection tests, view live logs, and change settings from any browser; there's also a 'sudo firefox-vpn' terminal menu.
Does using the VPN slow down access to local websites?No — smart routing detects local or regional sites and opens them directly outside the tunnel, so they load faster and don't count against your VPN data quota.
Creator
armanlife
Size
4.5 MB
Stars
645
Age
17d
Commits · 90 Days