diff --git a/README.rst b/README.rst
index f7ad69ff..27ba7b73 100644
--- a/README.rst
+++ b/README.rst
@@ -226,6 +226,21 @@ To test python code, run::
 Frontend
 --------
 
+The frontend tests ``npm test`` and ``npm run unit`` use a headless chrome
+driver and the driver requires the chromium-browser package to be installed on
+the system, you can do this by running::
+
+    $ sudo apt-get install chromium-browser
+
+.. note::
+    When using an operating system that is not ubuntu 16.04 the
+    process.env.CHROME_BIN variable may need to be updated in
+    openstack-health/test/karma.conf.js to reflect your system's chromium
+    path.
+
+    For example on SUSE Leap OS, process.env.CHROME_BIN = '/usr/bin/chromium'
+    must be set.
+
 To test javascript code, run::
 
     $ npm test