diff --git a/akka-samples/README.md b/akka-samples/README.md
new file mode 100644
index 0000000000..1059718002
--- /dev/null
+++ b/akka-samples/README.md
@@ -0,0 +1,8 @@
+Use Lightbend Activator to run samples
+--------------------------------------
+
+Use [Lightbend Activator](https://www.lightbend.com/activator/download) to run samples in this akka-samples directory.
+Follow the instruction on the Activator download page, and the [Activator documentation](https://www.lightbend.com/activator/docs).
+Once activator ui is up, you an find akka-sample-* projects by their names. 
+
+