Skip to content

About

Unofficial, open-source VPN client for Android, Windows, macOS, and Linux. Works with your own Mozilla account. Not affiliated with Mozilla.

Topics

Resources

Stars

628 stars

Watchers

7 watching

Forks

Latest commit

 

History

20 Commits

Folders and files

Repository files navigation


Arman VPN

Arman VPN

⚠️ Unofficial project

Not made, affiliated with, or endorsed by Mozilla. Firefox is a trademark of the Mozilla Foundation. See the disclaimer.

Downloads Last Version License

What is Arman VPN?

Arman 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.

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?

  • Android: if you are not sure, take Universal; it installs on every phone. ARMv8 is for most of today's phones and is smaller.
  • Windows: Setup is a normal installer; Portable needs no install and runs from any folder.
  • Linux: App for a Linux desktop (with a graphical environment); Core for a server (without a graphical environment, with a web panel).

💻 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

  • Panel address: http://SERVER-IP:10820/app/, with a username and password. The exact address is shown at the end of the install.
  • Proxy: SOCKS5 and HTTP on port 10810, with a username and password of its own.

⌨️ 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.

Disclaimer

This app is an independent, unofficial client. It is not made, affiliated with, or endorsed by Mozilla, and it is not a Mozilla product. Firefox and Mozilla are trademarks of the Mozilla Foundation.

You sign in with your own Mozilla account. The account's terms, data limit, and availability are set by Mozilla. Your password and sign-in tokens stay on your device.

About

Unofficial, open-source VPN client for Android, Windows, macOS, and Linux. Works with your own Mozilla account. Not affiliated with Mozilla.

Topics

Resources

Stars

628 stars

Watchers

7 watching

Forks

Releases

Contributors

Languages