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: standalone or the variant requiring .NET. macOS: a universal ZIP for macOS 15+, ad-hoc signed, without Developer ID/notarization or the per-app system extension. Android: a signed APK. Linux amd64: a binary or .deb. OpenWrt and Keenetic: choose your device architecture. No ready iOS package is included.

Open the official 0.8.2 release →
2

Verify SHA-256

Download SHA256SUMS from the same release. On Linux use sha256sum. On macOS calculate the ZIP hash with the built-in shasum -a 256 command and compare it with that file’s entry in SHA256SUMS. In PowerShell use Get-FileHash. The complete hash must match.

Linux
$ sha256sum -c SHA256SUMS --ignore-missing
macOS
$ shasum -a 256 Qeli-macOS-universal.zip
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