Install guide

Two ways to run BypassData: the BypassData Manager (recommended) downloads and runs everything for you, or install directly on Windows or Linux as a fallback.

Last updated: August 2026

Two ways to install

BypassData runs the same either way — a gateway with the web control panel built in. Choose how you want to set it up:

  • Option 1 — BypassData Manager (recommended) — a desktop app. Download it, press Start, and it downloads, verifies, runs and configures everything for you — on your Windows PC or on a Linux VPS over SSH. No command line.
  • Option 2 — Install directly — for people who prefer the manual route: unzip and run on Windows, or a one-line install on a Linux server.

Option 1 — BypassData Manager (recommended)

The recommended way to run BypassDataDownload one app and press Start — the Manager fetches the engine, verifies it, stores everything tidily in one fixed folder, then runs and configures BypassData for you. It handles both a local Windows PC and a remote Linux VPS.

You only download the Manager. Everything else — the gateway engine, the proxy core, your data and config — is fetched and kept in one fixed folder the first time you press Start.

Download and press StartThe Manager is a single Windows app — no installer needed. Download it, open it, and press Start; it downloads and verifies the engine, then runs and configures everything for you. Prefer the manual route? Option 2 below runs exactly the same engine.

  1. Download the Manager

    Download BypassData Manager and open it. It's a single app — nothing else to install up front.

  2. Press Start

    The first time you press Start, the Manager checks for the engine. If it's missing, it downloads the engine and proxy core, verifies the checksums, and stores them in a fixed folder — %LOCALAPPDATA%\BypassData. Your data and config live there too. Wait for the download to finish.

  3. Use the Manager

    Once the download completes, BypassData starts. From the Manager you can open the control panel, edit host / port / proxy settings, stop and restart it, and see which ports are listening.

  1. Add your VPS

    In the Manager's VPS tab, enter your server's SSH address and sign-in details. This connects the Manager to your own Linux server.

  2. Press Start / Install

    The Manager checks the server for BypassData. If it's not there, it downloads and installs the engine into a fixed folder (/opt/bypassdata), verifies it, and sets it up as a background service — all over SSH.

  3. Control it remotely

    From the same tab you can start, stop, restart, reconfigure, and fetch or reset the admin password on the server — no Linux knowledge required.

Everything in one folderThe engine, proxy core, your data, config and logs all live under one fixed folder (Windows: %LOCALAPPDATA%\BypassData, Linux: /opt/bypassdata). Nothing is scattered across your system, and removing BypassData is just deleting that folder.
Credentials stay on your machineSSH credentials you type into the VPS tab are used only for that session to reach your own server. They are never sent anywhere else.

Download the Manager (Windows) Windows 10/11 · 64-bit · v1.4.0 · 10.8 MB

Option 2 — Install directly

Prefer to do it yourself? You can run BypassData without the Manager on both Windows and Linux. This is the fallback path — the Manager (Option 1) is the recommended one.

Windows — manual

Grab the Windows archive and start the executable directly.

  1. Download & extract

    Download the Windows archive and extract it to a folder you can write to (for example your Documents folder).

  2. Run the executable

    Double-click bypassdata.exe, or run it from a terminal to see its log output. On first launch it generates an admin password and prints it to the console.

    PowerShell 
    > Expand-Archive bypassdata-windows-amd64.zip -DestinationPath .
> .\bypassdata-windows-amd64-v1.4.3\bin\bypassdata.exe

  3. Open the panel

    Browse to the panel address shown in the console and log in as admin. Your browser will warn about the self-signed certificate — that is expected; choose to proceed.

No admin rights neededThe Windows build is a normal user-space program. It does not install a service or modify system settings.

Linux / VPS

On a fresh Linux VPS you can install everything with a single command. Sign in to your server over SSH as root, then run:

One-line install (run as root) 
# curl -fsSL https://bypassdata.com/install.sh | sudo bash

The script downloads the latest release, installs BypassData as a systemd service under its own unprivileged user, starts it, and prints the initial admin password. The panel is only accessible from the server itself and is never exposed to the internet.

Prefer to do it by hand?

Download the Linux bundle, extract it, and run the bundled installer as root:

bash 
$ tar xzf bypassdata-linux-amd64.tar.gz
$ sudo ./bypassdata-*/deploy/install.sh

Reaching the panel

Because the panel is only accessible from the server itself, open an SSH tunnel from your own computer, then browse to the local address:

bash 
$ ssh -L 8443:127.0.0.1:8443 root@your-vps-ip
# then open https://127.0.0.1:8443 in your browser
Never expose a port with open authOn a public server, keep every proxy port on IP-whitelist or username/password auth. An open port exposed on a public address is an unauthenticated relay for the whole internet.

First run & the control panel

However you set it up, the first run creates an admin account and a control panel you log into from a browser.

  • The panel uses a self-signed TLS certificate and is meant to be reached locally (directly on Windows, or over an SSH tunnel on Linux). Your browser will ask you to trust it the first time.
  • Log in with the username admin and the generated password. Change the password after your first login.
  • From there, create proxy ports, set their authentication, and add your routing rules — see the user guide.

Open the user guide

Upgrading

There are three ways to move to a newer version — pick whichever matches how you installed:

  • With the Manager: it checks for a newer version and updates the engine for you — the easiest way, on Windows or a Linux VPS.
  • In-panel self-update (v1.2.0 and later): open the Updates page in the control panel and click Check for updates — BypassData downloads and applies the new release itself.
  • Manual: on Windows, stop the app and swap in the new files; on Linux, re-run the one-line installer. Your data folder is preserved either way.

Uninstalling

Removing BypassData is straightforward:

  • With the Manager: use its uninstall / cleanup action, or simply delete the fixed folder (Windows: %LOCALAPPDATA%\BypassData).
  • Windows manual: stop the program and delete its folder. Nothing was installed system-wide.
  • Linux: stop and disable the service, then remove its install directory (/opt/bypassdata).
Back up first if neededDeleting the data folder permanently removes your rules, ports, and encryption key. Export or copy anything you want to keep before removing it.