clover/chromium repository overview

⁠Chromium docker image

This image is based on official chromium build with debian libraries and it is built on top of clover/base⁠.

⁠Environment variables

* /usr/bin/chromium is a wrapper around /usr/lib/chromium/chromium binary that will be used by the chromedriver to launch the browser. It forcibly passes --headless and --disable-gpu arguments to the chromium binary. To override this behaviour pass /usr/lib/chromium/chromium as a binary to the chromedriver:

ChromeOptions options = new ChromeOptions();
options.setBinary("/usr/lib/chromium/chromium");

Wrapper also supports CHROMIUM_ARGUMENTS environment variable to define additional (default) set of command line arguments. Each argument may be overidden if passed to the chromedriver:

options.addArguments("--window-size=1920,1080");

chromedriver does not close browsers on its own. If client craches before sending quit signal, browser will never be closed. To prevent this wrapper has CHROMIUM_TIMEOUT environment variable that will set the execution cap of the chromium binary. This parameter is also available as an additional non-standard --process-timeout={seconds} command line argument. CHROMIUM_TIMEOUT is not set by default. If set to any positive non-zero value will cap execution time of each browser separately, unless command line argument is specified:

options.addArguments("--process-timeout=60");

To disable execution time capping set it to zero (0).

** There are three options to launch chromium in the docker:

• as root user with --no-sandbox argument;
• as non-root user with SYS_ADMIN docker capability (--cap-add=SYS_ADMIN);
• as non-root user with --no-sandbox argument;

By default, chromedriver will be running as chromium user (PUID=50, PGID=50). To launch under root specify PUID=0, PGID=0. Custom PUID/PGID could be used to preserve data volume ownership on host.

⁠Exposed ports

⁠Supported platforms

• linux/amd64;
• linux/386;
• linux/arm/v7;
• linux/arm64/v8;
• linux/ppc64le;