WaterWall

WaterWall is an open-source tunneling program. SRP VPN Connect contains a WaterWall client, and you run a WaterWall server. This section shows how to set up both sides the way we tested them.

What WaterWall is

WaterWall is a networking core written by the radkesvat project. Instead of offering one fixed VPN protocol, it gives you small building blocks called nodes: one listens on a port, one adds TLS, one speaks VLESS, one connects to the internet, and so on. You join nodes into a chain, and the chain decides what your connection looks like on the network.

The official WaterWall documentation, which explains every node in detail, is at radkesvat.github.io/WaterWall-Docs. This site does not repeat it; it explains how WaterWall works with SRP VPN Connect.

How SRP VPN Connect uses WaterWall

A connection has two halves that must match:

Apps on the phone
      |
      v
The system's VPN (a packet tunnel on iOS, a VpnService on Android)
      |
      v
WaterWall client chain in the app      e.g. VLESS -> TLS -> TCP
      |
      |   internet: the network sees only the outer layer (here TLS)
      v
WaterWall server chain on your server  e.g. TCP -> TLS -> VLESS
      |
      v
Websites and services

The phone sends its traffic into the system's VPN. WaterWall in the app wraps it in the layers you chose and sends it to your server. The server unwraps the same layers in reverse order and connects to the real destination.

The rule that matters most The layers in the app and on the server must match, in the same order, on the same port. If the app uses VLESS + TLS and the server port runs Trojan + TLS, the connection fails. Each scenario page shows both halves side by side.

What is in this section

RequirementsWhat you need, and the exact versions we tested. InstallationInstall the WaterWall server and the app. Getting StartedYour first working connection, step by step. Complete UI & Profile GuideEvery screen, field and option in the app. Configuration ReferenceServer files, and what the app builds for each choice. Verified Test ScenariosEach combination we tested, with its result. AndroidWhat differs from iPhone, and what we tested on Android. TroubleshootingWhat each message means and how to check the server. FAQShort answers to common questions.

Versions covered

This section covers the official WaterWall 1.5.42 release on the server and the iPhone and Android apps, which contain their own WaterWall built from 1.5.42. Results from other server programs are not used. The full version list is on the Requirements page.