**đŸ‡ē🇸 English**  /  [🇨đŸ‡ŗ įŽ€äŊ“中文](docs/readme/README_zh.md)  /  [🇷đŸ‡ē Đ ŅƒŅŅĐēиК](docs/readme/README_ru.md)  /  [🇮🇷 ŲØ§ØąØŗی](docs/readme/README_fa.md)

Firefox VPN

Firefox VPN

[![Downloads](https://img.shields.io/github/downloads/armanlife/firefox-vpn-client/total?style=flat-square&logo=github&label=Downloads)](https://github.com/armanlife/firefox-vpn-client/releases) [![Last Version](https://img.shields.io/github/v/release/armanlife/firefox-vpn-client?style=flat-square&label=Version)](https://github.com/armanlife/firefox-vpn-client/releases/latest) [![License](https://img.shields.io/github/license/armanlife/firefox-vpn-client?style=flat-square&label=License)](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 ⭐ 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: local sites open directly, faster and without using data 🔌 Several connection modes (VPN and proxy) 🔒 Encrypted DNS (DNS over HTTPS) 🌍 15 languages, including English, Persian, Chinese, and Russian 🌙 Light and dark themes 🛡 Open source, secure, and community-driven 🔄 Automatic update checks ## 📸 Screenshots

Home   Servers   Settings

## đŸ“Ĩ Download
SystemDownload
AndroidAPK Universal
APK ARMv8
APK ARMv7
APK x64
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. ```bash 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: ```text $ sudo firefox-vpn Firefox VPN ──────────────────────────────────────────────────────────────────────────── 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](docs/OPENWRT.md). ## Known limitations
What Mozilla's servers do not carry - **TCP only, no UDP:** voice and video calls in some apps, online games, and other UDP traffic do not go through. Browsers and most apps work normally. - **Web ports only:** Mozilla connects only to ports 80, 443, 8080, and 8443. 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. - **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.