Requirements
WaterWall needs two sides: the app on your iPhone, iPad or Android phone, and a WaterWall server that you run yourself. This page lists what each side needs and the exact versions we tested with.
On the phone
iPhone or iPad
- iOS or iPadOS 15.0 or later. This is the oldest system the app is built for.
- SRP VPN Connect. It is distributed through TestFlight; see Installation.
- Permission to add a VPN configuration. iOS asks for it the first time you connect.
Android
- Android 8.0 (API level 26) or later, on a 64-bit ARM device (arm64-v8a). These are the oldest system and the only processor type the app is built for. We tested it with Android 16 and 17; see what we tested.
- SRP VPN Connect. It is not in a store yet, so you build the APK from the source; see Installation.
- Permission to set up a VPN connection. Android shows a Connection request the first time you connect.
The app already contains WaterWall, so nothing else needs to be installed on the phone.
On the server
- A Linux server you control, with a public IP address and root access over SSH.
- WaterWall. Our server runs the official 1.5.42 release of the radkesvat/WaterWall project, unchanged, and every result on this site was measured against that program. Installation shows how to download and check it.
- Open ports in the server firewall for each configuration you run: TCP for most chains, UDP for QUIC, KCP and WireGuard.
- A domain name pointing at the server, if you use the TLS chains. The certificate comes from Let's Encrypt, which also needs TCP port 80 open for renewals.
Plain-English terms
- Chain
- WaterWall builds a connection from small parts called nodes, joined in order. For example: listen on TCP, then TLS, then VLESS, then connect to the internet.
- Port
- A number on the server that one configuration listens on, such as 18443.
Versions we tested
These are the exact versions on our test setup, read from the server and the phones on 9 and 10 November 2026. This site describes only this current setup; earlier versions are not covered.
| Part | Version | Where it came from |
|---|---|---|
| Server operating system | Ubuntu 24.04.5 LTS, Linux kernel 6.8.0 | Read from the server |
| Server machine | VMware virtual machine, 2 vCPUs, 2 GB RAM, x86-64 | Test server notes |
| WaterWall on the server | The official 1.5.42 release, unchanged (Waterwall-linux-gcc-x64.zip; the program's SHA-256 starts 38631081), installed as described in Installation | Waterwall --version, sha256sum and the release page |
| WaterWall inside the app | 1.5.42 (tag v1.5.42), with the app's own changes for phones on the client side | The app's source, WaterWall/UPSTREAM_VERSION and its change history |
| App | SRP VPN Connect 1.2.0, build 41 on TestFlight (commit e44cf11d). The tests ran on this commit and on f4425e02 and e69cb668, which change only the tests and the change log. Build 43 (commit c77b214b) adds the GeoIP routing of the Configuration Reference; the GeoIP and DNS resolver cases ran again on its code | The app's source |
| Test phone | iPhone 12 with iOS 27.2 | Read from the phone |
| Android app | SRP VPN Connect 1.2.0, debug APK of commit e44cf11d, with the same WaterWall folder as the iPhone app, and the signed release APK 1.2.0 (9) of the same commit. APK 1.2.0 (10), of commit c77b214b, adds the same GeoIP routing; the GeoIP and DNS resolver checks ran again on its code | The app's source |
| Android test devices | Samsung Galaxy A55 (SM-A556E) with Android 17 | Read from the devices |
| Certificate tool | certbot 2.9.0, Let's Encrypt, ECDSA key | Read from the server |
The server is the plain official release; the app has its own build
Our server runs the official WaterWall 1.5.42 program as published. The app contains its own build of WaterWall 1.5.42 with changes for phones on the client side; see
WaterWall/UPSTREAM_VERSION and the change history in the app's source. Everything marked as verified on this site was tested with exactly this pair.
Before you continue
Checklist
- You can log in to your server as root with SSH.
- You know your server's public IP address. If you will use TLS, you also have a domain name pointing at it.
- You have an iPhone or iPad with iOS 15 or later and the TestFlight app, or an Android device or emulator with Android 8.0 or later and a computer to build the APK on.