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

Android

The app already contains WaterWall, so nothing else needs to be installed on the phone.

On the server

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.

PartVersionWhere it came from
Server operating systemUbuntu 24.04.5 LTS, Linux kernel 6.8.0Read from the server
Server machineVMware virtual machine, 2 vCPUs, 2 GB RAM, x86-64Test server notes
WaterWall on the serverThe official 1.5.42 release, unchanged (Waterwall-linux-gcc-x64.zip; the program's SHA-256 starts 38631081), installed as described in InstallationWaterwall --version, sha256sum and the release page
WaterWall inside the app1.5.42 (tag v1.5.42), with the app's own changes for phones on the client sideThe app's source, WaterWall/UPSTREAM_VERSION and its change history
AppSRP 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 codeThe app's source
Test phoneiPhone 12 with iOS 27.2Read from the phone
Android appSRP 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 codeThe app's source
Android test devicesSamsung Galaxy A55 (SM-A556E) with Android 17Read from the devices
Certificate toolcertbot 2.9.0, Let's Encrypt, ECDSA keyRead 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