Chromium

Container image for browser automation with FOIAcquire. Exposes Chrome DevTools Protocol (CDP) on port 9222 via socat proxy.

Based on Alpine 3.21 with Chromium, pinned for compatibility with chromiumoxide.

Variants

Tag	Description
latest	Anti-detection flags + Tor routing by default
clearnet	Standard headless Chromium (no Tor, no stealth)

Usage

docker run -d --name chromium -p 9222:9222 --shm-size=2g ghcr.io/foiacquire/chromium:latest

Without Tor/stealth:

docker run -d --name chromium -p 9222:9222 --shm-size=2g ghcr.io/foiacquire/chromium:clearnet

Connect from FOIAcquire:

browser:
  enabled: true
  remote_url: ws://chromium:9222

Environment Variables

Variable	Default	Description
STEALTH	false	Enable anti-detection flags (set at build or runtime)
FOIACQUIRE_DIRECT	unset	Set to 1 to disable Tor in stealth mode
SOCKS_PROXY	unset	Custom SOCKS proxy (when Tor is disabled)
VNC_PASSWORD	unset	Enable VNC on port 5900 with this password
VNC_VIEWONLY	false	Set to true for read-only VNC
XVFB_SLEEP_TIMEOUT	3	Seconds to wait for Xvfb startup
BROWSER_SLEEP_TIMEOUT	5	Seconds to wait for Chromium startup

Building

# Standard
docker build -t chromium .

# Stealth
docker build --build-arg STEALTH=true -t chromium:stealth .

License

MIT