Configuration.notes - kubed-io/selenium-flow GitHub Wiki

One value in each place

# /etc/selenium-flow/config.yaml
workspace:
  ttl: 86400
redis:
  host: redis.data
  db: 2

export CONFIG_FILE=/etc/selenium-flow/config.yaml
export GRID_URL=http://selenium-hub:4444
selenium-flow --log-level DEBUG

The Settings tab of the admin UI shows every value and where it came from.

Worth setting

session.page_load_timeout: with no bound, one hung page holds a Grid slot until the Grid reaps it.

The environment is lenient, the file is not

An environment variable the server does not know is ignored: Kubernetes injects <SERVICE>_PORT variables into every pod. A key the file does not know stops the boot, because it is a typo.

The exception: a Kubernetes Service literally named redis injects REDIS_PORT=tcp://…, which is a known leaf and stops the boot on a value that was never meant as one. Hence enableServiceLinks: false on the pod.

Lists and booleans in env and flags

secrets.dirs splits like PATH, on the OS path separator (:). A boolean setting accepts true/false, 1/0, yes/no and on/off.

Secrets

The file's secrets.entries section defines secrets. See Secrets.

OIDC needs the token

oidc without auth.token stops the boot. oidc.roles_claim walks objects on dots: realm_access.roles reads {"realm_access": {"roles": [...]}}.