Repository navigation
getting-started.md sample config is missing required execution.mode field #41
Description
File: docs-site/docs/getting-started.md, Step 2 (currently around lines 79-98), the selenium-boot.yml sample.
The sample config has browser:, execution: baseUrl:, retry:, and timeouts: — but no execution.mode.
ConfigurationLoader.validate() (selenium-boot/src/main/java/com/seleniumboot/config/ConfigurationLoader.java) throws IllegalStateException("Execution mode must be specified") when execution.mode is absent, and further requires it be exactly local or remote.
Repro
Fresh Maven project (Java 17+, Maven 3.8+):
- Paste the doc's Step 1 dependency block.
- Paste the doc's Step 2 YAML verbatim.
- Paste the doc's Step 3 test class.
- Paste the doc's Step 4 testng.xml.
- Run
mvn test.
Actual output
[ERROR] Selenium Boot failed to initialize. Aborting test suite execution.
followed by
org.apache.maven.surefire.booter.SurefireBooterForkException: There was an error in the forked process
No mention of what's actually wrong — you have to know to check ConfigurationLoader to find out execution.mode is required.
Suggested fix
Add mode: local under execution: in the doc's Step 2 sample.
Activity
GameMaster97 commentedon Sep 15, 2026
getting-starded.md already has your suggsted fix, did you forget to close the issue?
shossain786 commentedon Sep 16, 2026
Already fixed — the docs sample has had
execution.mode: localsince 2026-09-12's 37863a2 (#44, fixing #43). Thanks for the flag, @GameMaster97 — this one just slipped through unclosed.feat(config): zero-config first run — selenium-boot.yml is now option…