diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..91ea745
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,53 @@
+
+==========================================
+Tempest with plugins environment container
+==========================================
+
+
+Tempest with plugins environment container.
+Those container supposed to have any needed set of tempest tests
+for running on any custom cloud.
+
+Container statements:
+=====================
+
+  * Downstream tempest with set of downstream plugins
+  * Align to upstream openstack upper-constraints.txt
+  * No-auto-magic things, by default.
+  * All configs should be **connected** as volumes to container.
+  * All preconfigured things, like:
+    -create networks
+    -create tempest conf
+    -add\patch plugin
+    should be done in separate steps.
+  * Open entrypoint - any customization allowed and could be passed:
+    - via cmdline for docker run
+    - via SWITCH env variables + new func in entrypoint
+  * If needed, any custom scripts could be added, but should be disable by default.
+
+
+
+Example run:
+============
+
+Example for custom tempest run:
+
+.. caution::
+
+   **tempest_generated.conf** should be previously generated, along with all needed resources in cloud.
+
+   ``log_dir`` variable in conf, should be pointed to ``/temepest_reports`` - otherwise, you need to
+   change cmdline accordingly.
+
+
+
+.. code-block:: bash
+
+   mkdir -p /root/test_example/; cd /root/test_example/ ;
+   mkdir -p temepest_reports/ # create local folder, to save results
+   rm -rf temepest_reports/test1  # remove old results, ff was
+   docker run -v $(pwd)/tempest_generated.conf:/etc/tempest/tempest.conf -v $(pwd)/temepest_reports:/temepest_reports --rm -it 858b99100d04  /bin/bash -c "cd /temepest_reports; tempest init test1 ; cd test1; tempest run --debug -r heat_tempest_plugin.tests.api.test_heat_api.stacks_patch_update_stack.test_request
+
+
+
+