1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
<div align="center">
**đēđ¸ English** / [đ¨đŗ įŽäŊä¸æ](docs/readme/README_zh.md) / [đˇđē Đ ŅŅŅĐēиК](docs/readme/README_ru.md) / [đŽđˇ ŲØ§ØąØŗÛ](docs/readme/README_fa.md)
</div>
<br>
<p align="center"><img src="docs/images/logo.png" width="128" alt="Firefox VPN"></p>
<h1 align="center">Firefox VPN</h1>
<div align="center">
[](https://github.com/armanlife/firefox-vpn-client/releases)
[](https://github.com/armanlife/firefox-vpn-client/releases/latest)
[](LICENSE)
</div>
## 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.
<p align="center"><a href="https://raw.githubusercontent.com/armanlife/firefox-vpn-client/main/docs/screenshots/main.webp" target="_blank"><img src="docs/screenshots/main.webp" width="720" alt="Firefox VPN"></a></p>
## đ 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
<p align="center">
<img src="docs/screenshots/phone_01.webp" width="240" alt="Home">
<img src="docs/screenshots/phone_02.webp" width="240" alt="Servers">
<img src="docs/screenshots/phone_03.webp" width="240" alt="Settings">
</p>
## đĨ Download
<table>
<thead>
<tr><th>System</th><th>Download</th></tr>
</thead>
<tbody>
<tr><td>Android</td><td><a href="https://github.com/armanlife/firefox-vpn-client/releases/latest/download/Firefox-VPN-Android-universal.apk"><img src="https://img.shields.io/badge/APK-Universal-1a7f37?logo=android&logoColor=white" alt="APK Universal"></a><br><a href="https://github.com/armanlife/firefox-vpn-client/releases/latest/download/Firefox-VPN-Android-arm64-v8a.apk"><img src="https://img.shields.io/badge/APK-ARMv8-2da44e?logo=android&logoColor=white" alt="APK ARMv8"></a><br><a href="https://github.com/armanlife/firefox-vpn-client/releases/latest/download/Firefox-VPN-Android-armeabi-v7a.apk"><img src="https://img.shields.io/badge/APK-ARMv7-4ac26b?logo=android&logoColor=white" alt="APK ARMv7"></a><br><a href="https://github.com/armanlife/firefox-vpn-client/releases/latest/download/Firefox-VPN-Android-x86_64.apk"><img src="https://img.shields.io/badge/APK-x64-6fdd8b?logo=android&logoColor=white" alt="APK x64"></a></td></tr>
<tr><td>Windows</td><td><a href="https://github.com/armanlife/firefox-vpn-client/releases/latest/download/Firefox-VPN-Windows-Setup-x64.exe"><img src="https://img.shields.io/badge/Setup-x64-0550ae?logo=windows&logoColor=white" alt="Setup x64"></a><br><a href="https://github.com/armanlife/firefox-vpn-client/releases/latest/download/Firefox-VPN-Windows-x64.zip"><img src="https://img.shields.io/badge/Portable-x64-0969da" alt="Portable x64"></a></td></tr>
<tr><td>macOS</td><td><a href="https://github.com/armanlife/firefox-vpn-client/releases/latest/download/Firefox-VPN-macOS.dmg"><img src="https://img.shields.io/badge/DMG-Universal-24292f?logo=apple&logoColor=white" alt="DMG Universal"></a></td></tr>
<tr><td rowspan="2">Linux</td><td><a href="https://github.com/armanlife/firefox-vpn-client/releases/latest/download/Firefox-VPN-Linux-amd64.tar.gz"><img src="https://img.shields.io/badge/App-amd64-e36209?logo=linux&logoColor=white" alt="App amd64"></a><br><a href="https://github.com/armanlife/firefox-vpn-client/releases/latest/download/Firefox-VPN-Linux-arm64.tar.gz"><img src="https://img.shields.io/badge/App-ARM64-e36209?logo=linux&logoColor=white" alt="App ARM64"></a></td></tr>
<tr><td><a href="https://github.com/armanlife/firefox-vpn-client/releases/latest/download/firefox-vpn-core-linux-amd64.tar.gz"><img src="https://img.shields.io/badge/Core-amd64-f0883e?logo=linux&logoColor=white" alt="Core amd64"></a><br><a href="https://github.com/armanlife/firefox-vpn-client/releases/latest/download/firefox-vpn-core-linux-arm64.tar.gz"><img src="https://img.shields.io/badge/Core-ARM64-f6a35e?logo=linux&logoColor=white" alt="Core ARM64"></a></td></tr>
</tbody>
</table>
**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.
<p align="center"><img src="docs/screenshots/web.webp" width="720" alt="Web panel"></p>
- **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
ââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
1) Status firefox-vpn status
2) Start firefox-vpn start
3) Stop firefox-vpn stop
4) Restart firefox-vpn restart
5) Start with the server firefox-vpn enable
6) Do not start with the server firefox-vpn disable
7) Show the log firefox-vpn logs
8) Add a Firefox Account firefox-vpn add-account
9) List the accounts and their quota firefox-vpn list-accounts
10) Set the panel's username and password firefox-vpn set-dashboard-login
11) Update to the newest version firefox-vpn update
0) Exit
ââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
Enter a number [0-11]:
```
## Known limitations
<details>
<summary>What Mozilla's servers do not carry</summary>
- **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.
</details>
arblant