Files
goclaw/docker-compose.browser.yml
T
viettranx feca0a25e4 fix(docker): swap browser sidecar to chromedp/headless-shell
zenika/alpine-chrome is stuck at v124 — upstream stopped publishing
newer tags — and v124 with default headless mode doesn't support
--load-extension, so users couldn't load Chrome extensions during
automation.

Switch to chromedp/headless-shell:latest (Chrome 147+ at time of
commit, auto-tracks Chrome for Testing) and add --headless=new so
extension loading works. Rod connects to the same raw-CDP
ws://chrome:9222 endpoint — no client code change.

The image's entrypoint already configures the debugging port and
fronts it with socat, so our explicit --remote-debugging-*
flags have to be removed (otherwise Chrome fails with
"bind() failed: Address already in use").

Healthcheck switched from wget (absent in the minimal image) to a
bash /dev/tcp probe (bash is present and sufficient for a liveness
check on port 9222).

Verified: image pulls, Chrome starts, /json/version returns, health
probe succeeds.

Closes #722
2026-04-18 16:55:08 +07:00

51 lines
1.9 KiB
YAML

# Browser sidecar overlay — adds headless Chrome for the browser automation tool.
#
# Usage:
# docker compose -f docker-compose.yml -f docker-compose.postgres.yml -f docker-compose.browser.yml up -d --build
#
# The Chrome sidecar exposes CDP (Chrome DevTools Protocol) on port 9222.
# GoClaw connects to it automatically via GOCLAW_BROWSER_REMOTE_URL.
services:
chrome:
# chromedp/headless-shell auto-tracks Google Chrome for Testing and serves
# raw CDP on :9222 — same wire format Rod expects, no client code change.
# Replaces zenika/alpine-chrome:124, which stopped publishing new tags and
# doesn't support `--load-extension` in its default headless mode (#722).
image: chromedp/headless-shell:latest
# The image's entrypoint already sets --remote-debugging-address=0.0.0.0
# and --remote-debugging-port=9223, and fronts it with socat on :9222.
# Re-specifying those flags here duplicates them and causes Chrome to
# fail with "bind() failed: Address already in use". Pass only the
# goclaw-specific tweaks (headless mode, origin allowlist, GPU off).
command:
- --no-sandbox
# New headless (Chrome 112+) is required for --load-extension to work.
- --headless=new
- --remote-allow-origins=*
- --disable-gpu
- --disable-dev-shm-usage
ports:
- "${CHROME_CDP_PORT:-9222}:9222"
shm_size: 2gb
healthcheck:
# chromedp/headless-shell is minimal — no wget/curl/nc. Use bash's
# /dev/tcp builtin to probe the CDP port directly (bash is in the image).
test: ["CMD", "bash", "-c", "exec 3<>/dev/tcp/127.0.0.1/9222"]
interval: 5s
timeout: 3s
retries: 5
deploy:
resources:
limits:
memory: 2G
cpus: '2.0'
restart: unless-stopped
goclaw:
environment:
- GOCLAW_BROWSER_REMOTE_URL=ws://chrome:9222
depends_on:
chrome:
condition: service_healthy