Add basic instructions for running browser tests
@@ -257,6 +257,19 @@ Refer to the [Building Web
Driver](https://github.com/SeleniumHQ/selenium/wiki/Building-WebDriver)
wiki page for the last word on building the bits and pieces of Selenium.
+## Running Browser Tests on Linux
+
+You can run browser tests on linux in xvfb or xnest. You also need to install
+the browser-specific drivers (`geckodriver`, `chromedriver`, etc.) - you need
+to download them separately and put them on your `PATH`.
+
+1. Run the X server `Xvfb :99` or `Xnest :99`
+2. Run a window manager, for example `DISPLAY=:99 jwm`
+3. Run the tests you are interested in:
+```sh
+bazel test --test_env=DISPLAY=:99 //java/... --test_tag_filters=chrome
+```
+
## Bazel Installation/Troubleshooting
### MacOS
