Platform Support¶

Detailed platform compatibility matrix for recurl.

Support Matrix¶

Platform	Arch	recurl	Impersonation	JS Preflight	Chromium Auto-Download
Linux	x86_64	✓	✓	✓	✓
Linux	aarch64	✓	✓	✓	Manual*
macOS	x86_64	✓	✓	✓	✓
macOS	aarch64	✓	✓	✓	✓
Windows	x86_64	✓	✗	✓	✓
Windows	i686	✓	✗	✓	✓

*Linux ARM64: Chromium must be installed manually.

Linux¶

x86_64 (Intel/AMD 64-bit)¶

Full support. All features available.

# Install
curl -fsSL https://recurl.dev/install.sh | bash

# Verify
recurl --version

aarch64 (ARM 64-bit)¶

Partial support. Chromium auto-download not available.

# Install recurl
curl -fsSL https://recurl.dev/install.sh | bash

# Install Chromium manually
# Ubuntu/Debian:
sudo apt update && sudo apt install -y chromium-browser

# Fedora:
sudo dnf install -y chromium

# Arch Linux:
sudo pacman -S chromium

recurl will automatically detect system Chromium at:

/usr/bin/chromium
/usr/bin/chromium-browser
/usr/bin/google-chrome
/snap/bin/chromium

macOS¶

aarch64 (Apple Silicon)¶

Full support. All features available.

# Install via Homebrew
brew install recurl/tap/recurl

# Or via script
curl -fsSL https://recurl.dev/install.sh | bash

x86_64 (Intel)¶

Full support. All features available.

Same installation as Apple Silicon.

Windows¶

x86_64 (64-bit)¶

Partial support. No impersonation layer.

# Install via Scoop
scoop bucket add recurl https://github.com/user/recurl
scoop install recurl

# Or via script
irm https://recurl.dev/install.ps1 | iex

Notes:

curl-impersonate is not available for Windows
recurl skips directly from curl_engine to JS preflight
Daemon uses named pipes instead of Unix sockets

i686 (32-bit)¶

Partial support. Same limitations as x86_64.

Feature Comparison by Platform¶

Escalation Chain¶

Linux / macOSWindows

curl_engine → impersonation → JS preflight

Three-layer escalation with browser TLS fingerprinting.

curl_engine → JS preflight

Two-layer escalation (impersonation skipped).

Daemon Transport¶

Platform	Transport	Path
Linux	Unix socket	`/tmp/recurl.<uid>.sock`
macOS	Unix socket	`/tmp/recurl.<uid>.sock`
Windows	Named pipe	`\\.\pipe\recurl-<username>`

Chromium Cache Location¶

Platform	Path
Linux	`~/.local/share/recurl/chromium/`
macOS	`~/Library/Application Support/recurl/chromium/`
Windows	`%LOCALAPPDATA%\recurl\chromium\`

Docker¶

Docker support is available for containerized usage:

# Pull official image
docker pull ghcr.io/user/recurl

# Run request
docker run --rm ghcr.io/user/recurl https://example.com

The Docker image includes:

recurl and recurld binaries
curl_engine
curl-impersonate binaries (Linux x86_64)
Pre-downloaded Chromium

Building from Source¶

Requirements¶

Platform	Requirements
Linux	Rust 1.75+, pkg-config, OpenSSL dev headers
macOS	Rust 1.75+, Xcode command line tools
Windows	Rust 1.75+, Visual Studio Build Tools (C++)

Build Commands¶

LinuxmacOSWindows

sudo apt-get install build-essential pkg-config libssl-dev
cargo build --release

xcode-select --install
cargo build --release

cargo build --release

Known Limitations¶

Linux ARM64¶

Chromium auto-download not supported (upstream limitation)
Manual Chromium installation required
All other features work normally

Windows¶

No curl-impersonate support (no TLS fingerprint mimicry)
Impersonation layer skipped entirely
--recurl-impersonate flag has no effect
JS preflight available as primary bypass

All Platforms¶

CAPTCHA that requires human interaction cannot be bypassed
Some behavioral analysis systems may still detect automation
IP-based rate limiting is not bypassed

Checking Your Platform¶

# Show platform info
uname -a

# Check Chromium availability
which chromium chromium-browser google-chrome

# Test recurl features
recurl --recurl-debug https://httpbin.org/get