@sport-use/camoufox-server

Self-hosted browser server for sport-use. Runs a Camoufox (anti-detection Firefox) instance on your machine and connects it to your dashboard via Cloudflare tunnel -- your browser data never leaves your network.

Requirements

• Bun runtime (required -- this package uses Bun-native APIs and must be run with bunx / bun run)
• macOS or Linux (Windows is not supported yet -- see Platform Support)

Usage

bunx @sport-use/camoufox-server

Everything is auto-installed on first run (Camoufox browser binary + cloudflared). A tunnel URL will be printed -- paste it into your dashboard:

Settings > Browser > Camoufox > Tunnel URL

Options

bunx @sport-use/camoufox-server --port 9090      # Custom port (default: 2026)
bunx @sport-use/camoufox-server --no-tunnel       # Local only, no tunnel

Platform Support

| Platform | Status | Notes | |----------|--------|-------| | macOS (Apple Silicon & Intel) | Supported | Recommended for local development | | Linux (x64) | Supported | Recommended for production / VPS | | Windows | Not supported | Camoufox upstream (v146) does not ship stable Windows binaries yet. See daijro/camoufox for updates. |

Why Bun?

This package relies on Bun-native APIs (Bun.serve, Bun.spawn, etc.) and is not compatible with Node.js. Install Bun at bun.sh if you haven't already.

Manual Tunnel

If the built-in tunnel fails, start the server without it and map the tunnel yourself:

bunx @sport-use/camoufox-server --no-tunnel

Then in another terminal:

# Cloudflare
cloudflared tunnel --url http://localhost:2026

# or ngrok
ngrok http 2026

Paste the public URL into your dashboard the same way.

Linux VPS

On a headless Linux server, the browser needs a virtual display. Install xvfb and run with it:

sudo apt install xvfb
xvfb-run bunx @sport-use/camoufox-server