diff --git a/install/ui/test/README b/install/ui/test/README
deleted file mode 100755
index 96e7f9e80..000000000
--- a/install/ui/test/README
+++ /dev/null
@@ -1 +0,0 @@
-http://www.freeipa.org/page/UI_Unit_Tests
diff --git a/install/ui/test/README.md b/install/ui/test/README.md
new file mode 100644
index 000000000..05fd92194
--- /dev/null
+++ b/install/ui/test/README.md
@@ -0,0 +1,18 @@
+# WebUI Unit Tests
+
+How to run tests:
+
+1. Run "autoreconf" command in the root of the repository
+2. Run "./configure" in the root of the repository
+3. Go to install/ui/src/libs/ directory
+4. Run "$ make" - this step generates loader.js which is necessary for load
+    current API version into WebUI. This version is necessary for checking
+    response of each API call.
+5. Go to install/ui/test
+6. Run "$ firefox index.html"
+
+Only Firefox browser is supported, because Google Chrome does not allow
+to fetch files using AJAX and file:// protocol.
+
+For more information about WebUI unit tests please read following:
+https://www.freeipa.org/page/FreeIPAv2:UI_Unit_Tests