Connect devices

Download and configure a Qeli client

Use builds from the official GitHub Release only, verify SHA-256 and import the qeli:// link issued by your server.

1

Choose the file for your platform

Windows: the standalone build or the build that requires .NET. macOS: the universal ZIP. Android: the signed APK. Linux amd64: a standalone binary or .deb package. The release does not yet ship a ready iOS build.

Open the official 0.8.1 release →
2

Verify SHA-256

Download SHA256SUMS from the same release next to the installer. Use sha256sum on Linux/macOS or Get-FileHash in PowerShell; the result must exactly match the selected file's entry.

Linux / macOS
$ sha256sum -c SHA256SUMS --ignore-missing
Windows PowerShell
PS> Get-FileHash .\QeliWin-standalone.exe -Algorithm SHA256
3

Import qeli://

Get a link from your server: the installer stores links in /etc/qeli/client-links/, while the panel can display a link and QR code. Import the profile, make sure the server key is pinned and test the connection before changing additional routes.

After the first successful connection, choose full tunnel for all traffic or split tunnel for selected subnets. Windows and macOS can use route_file for long local lists.
Routing Per-app routing Troubleshooting