--- title: Desktop runtime description: "CaptchaLa desktop runtime 1.2.0: the native libraries for Windows, macOS and Linux used by the Electron and Flutter desktop SDKs, supported platforms, and SHA256SUMS for verifying or mirroring them." --- # Desktop runtime The CaptchaLa desktop runtime is the set of native libraries for **Windows**, **macOS** and **Linux** that the desktop SDKs are built on. Current version: **1.2.0**. You don't integrate the runtime directly. Use one of these SDKs; they bundle or fetch the matching runtime for you: - **[Electron SDK](./electron)** (`@captcha-la/electron`): the npm package contains the runtime for every supported target. - **[Flutter SDK](./flutter)** (`captchala`): on Windows and Linux the plugin downloads the runtime at build time and checks it against pinned SHA-256 hashes. Native macOS apps use the [iOS / macOS SDK](./ios). ::: tip Need direct integration? If neither Electron nor Flutter fits your app, [contact us](https://dash.captcha.la/support). ::: ## Platforms {#platforms} | Platform | Architectures | Captcha window | | --- | --- | --- | | Windows 10 1809+ and Windows Server | x64, arm64, x86 | Native window (Microsoft Edge WebView2 Runtime) | | Linux, glibc 2.17+ | x64, arm64 | Native window: GTK 3 and WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+ or equivalent) | | macOS 11+ | arm64, x64 | Used by the Electron SDK | Since 1.2.0 the runtime also loads on Windows Server, including Server Core and terminal servers, without installing any extra Windows feature. On Linux systems older than Ubuntu 22.04 / Debian 12 the native captcha window is not available; the Electron SDK shows the captcha in its own window there. ## Download and verification {#download} The libraries are published on the versioned package CDN with checksums, for security reviews or to mirror them inside your network: - Base URL: `https://pkg.captcha-pkg.net/desktop/1.2.0/` (mirror: `https://pkg.captcha-cdn.net/desktop/1.2.0/`) - [`SHA256SUMS`](https://pkg.captcha-pkg.net/desktop/1.2.0/SHA256SUMS) lists every file with its SHA-256; one folder per target: `linux-x64`, `linux-arm64`, `win32-x64`, `win32-arm64`, `win32-ia32`, `darwin-arm64`, `darwin-x64` ```bash # Linux (use "shasum -a 256 -c -" on macOS) BASE=https://pkg.captcha-pkg.net/desktop/1.2.0 TARGET=linux-x64 mkdir -p vendor/captchala/1.2.0 && cd vendor/captchala/1.2.0 curl -fsSLO "$BASE/SHA256SUMS" for f in $(grep " $TARGET/" SHA256SUMS | awk '{print $2}'); do mkdir -p "$(dirname "$f")" && curl -fsSL -o "$f" "$BASE/$f" done grep " $TARGET/" SHA256SUMS | sha256sum -c - # every line must say OK ``` On Windows, compare `Get-FileHash -Algorithm SHA256` with the line in `SHA256SUMS`. To build a Flutter desktop app from a mirror, point `CAPTCHALA_LOCAL_PREBUILDS` at the folder (see [Flutter: native libraries](./flutter#native-libraries-desktop)). ## Requirements {#requirements} - **Windows:** Windows 10 1809+ or Windows Server; Microsoft Edge WebView2 Runtime for the captcha window. - **Linux:** glibc 2.17+ and libcurl; GTK 3 and WebKitGTK 4.1 (`webkit2gtk-4.1`) for the captcha window. - **macOS:** macOS 11+. ## Server-side validation Whichever SDK you use, send the pass token to your backend and validate it with `POST https://verify.captcha.la/v1/validate`. See the [API Reference](../api-reference).