diff --git a/README.md b/README.md
index 143d828cf226a1570788bf7dac9ca8281b8c55ae..de0a5116834d1a702aaf3037edb9e4a17471552c 100644
--- a/README.md
+++ b/README.md
@@ -119,7 +119,8 @@ for more information.
 ## OpenHarmony host tools
 
 To facilitate working with OpenHarmony systems, an image with various host tools
-is provided.
+is provided. The ACTS test suite for testing for OpenHarmony compatibility can
+be included in this image.
 
 See [recipes-openharmony/tools/README.rst](recipes-openharmony/tools/README.rst)
 for more information.
diff --git a/recipes-openharmony/tools/README.rst b/recipes-openharmony/tools/README.rst
index 94f14cb5e2704b2604901dbfef66388c25ad2983..9888d47684f542bb41c4b3ecf457d7c0b456da85 100644
--- a/recipes-openharmony/tools/README.rst
+++ b/recipes-openharmony/tools/README.rst
@@ -25,6 +25,10 @@ Once that is in place, the `bitbake` command is simply::
 
     DISTRO=oniro-openharmony-linux MACHINE=qemuarma7 bitbake openharmony-tools
 
+The default configuration (as defined in
+[local.conf.sample](conf/local.conf.sample)), enables building of ACTS and
+inclusion in the `openharmony-tools` image.
+
 
 Installation
 ************
@@ -46,3 +50,25 @@ In order to use the installed tools, you need to setup your shell environment
     $ . /opt/openharmony-tools/environment-setup-x86_64-oesdk-linux
 
 And with that, you will have access to `hdc` and `xdevice` commands.
+
+
+Running ACTS
+============
+
+To run ACTS tests, you need to connect to the OpenHarmony target device (or
+QEMU) using `hdc` and then run the tests using `xdevice` command.
+(remember to setup the environment as show in the section above)
+
+As an example, running the `ActsContextTest.json` test case against QEMU target
+(IP address 192.168.7.2), run
+
+.. code-block::
+
+    $ hdc tconn 192.168.7.2:35000
+    Connect OK
+    $ xdevice run acts -l ActsContextTest
+    [2023-02-20 13:25:22,954] [Main] [INFO] [*************** xDevice Test Framework Starting ***************]
+    [2023-02-20 13:25:22,975] [Utils] [INFO] [The running command is: hdc_std -s tcp:8710 reset]
+    [2023-02-20 13:25:23,980] [Console] [INFO] [Input command: run -l ActsContextTest]
+    ...
+