ByeHow to install ByeDPI
Pick your platform. Both routes take about five minutes, and both end with the same test: opening a site your provider blocks.
Before you start
Download only from the official GitHub sources described on the download page. There is no installer to pay for, no account to create, and nothing else to install first on any platform. On desktop you will also need to change one proxy setting in your browser or system afterwards — ByeDPI cannot do that part for you, because it is a local proxy, not a system driver.
Android
Get the APK
Open the ByeDPIAndroid releases page and download the APK from the latest release. If you use Obtainium, add the repository URL instead and let it fetch the release.
Install the APK
Tap the downloaded file. If Android asks, allow installs from your browser or file manager for this one install.
Open the app and tap Start
Accept the VPN connection request. Android shows this prompt because the app routes traffic through its local proxy using VPN mode — no remote server is involved.
Test a blocked site or app
If it opens, you are done. If not, do not reinstall — change the strategy in the app's Settings using the best settings guide, one change at a time.
More about the app itself, including proxy mode and AdGuard, is on the ByeDPI for Android page.
Linux
Get the core
Download a release for your system from the hufrea/byedpi releases page, or clone the repository and build it with the included Makefile.
Run the proxy
Start it with a desync method. A documented starting point on Linux is:
ciadpi --disorder 1 --auto=torst --tlsrec 1+s
# another documented option:
ciadpi --fake -1 --md5sigPoint your browser at the proxy
Set a SOCKS5 proxy with host 127.0.0.1 and port 1080. Exact steps per browser and operating system are in the SOCKS proxy setup guide.
Test, then tune
Open a blocked site. On Linux the full method set is available, including --md5sig and daemon mode (--daemon) for running it in the background.
Windows
Get the core
Download the Windows release from the same official releases page and unpack it to a folder you will keep.
Run the proxy
The documented Windows starting point combines split with disorder, because --fake can be less stable on Windows on its own:
ciadpi --split 1+s --disorder 3+sSet the proxy and test
Use the same SOCKS5 setting — 127.0.0.1, port 1080 — then test a blocked site. Leave the ByeDPI window running while you browse; closing it stops the proxy.
How to verify it is working
- A site or service that was blocked or throttled now opens with ByeDPI running — and fails again when you stop ByeDPI. That on/off difference is the real test.
- Normal, unblocked sites should behave exactly as before, at the same speed.
- If nothing loads at all, the problem is almost always the proxy setting (wrong host, port, or proxy type), not the bypass method. Check the troubleshooting guide.
Removing ByeDPI
There is nothing deep to uninstall. On Android, stop the app and uninstall it like any other app; the VPN permission disappears with it. On desktop, stop the program, remove its files, and remove the SOCKS proxy setting from your browser or system — an important last step, because a browser left pointing at 127.0.0.1:1080 with no proxy running will fail to load anything.