Skip to content

Build from source

SGavrl edited this page May 30, 2026 · 1 revision

Requirements

  • Rust 1.75+ (rustup.rs)
  • C compiler (gcc or clang)
  • ~5 GB free disk space (V8 compiles from source on first build)

First build takes about 5 minutes. Incremental builds are seconds.

Build

git clone https://github.com/h4ckf0r0day/obscura.git
cd obscura
cargo build --release

Binary is at ./target/release/obscura.

With stealth

cargo build --release --features stealth

Adds TLS fingerprint randomization and the tracker blocklist. See Configure stealth and proxies.

OpenSSL on older systems

If the build fails on the vendored OpenSSL with an AVX-512 assembler error (common on older VPS hosts):

OPENSSL_NO_VENDOR=1 cargo build --release

Uses the system OpenSSL instead.

Run from the build

./target/release/obscura --version
./target/release/obscura fetch https://example.com --eval "document.title"

Install system-wide:

cargo install --path crates/obscura-cli

Tests

cargo test --release

Integration suite:

python3 tests/test_all.py

Clone this wiki locally