+ :depth: 3
+
+
+Starting the ONAP Policy Framework Docker Containers
+****************************************************
+In order to start the containers, you can use *docker-compose*. This uses the *docker-compose.yml* yaml file to
+bring up the ONAP Policy Framework. This file is located in the policy/docker repository. In the csit folder there
+are scripts to *automatically* bring up components in Docker, without the need to build all the images locally.
+
+Clone the read-only version of policy/docker repo from gerrit:
+
+.. code-block:: bash
+
+ git clone "https://gerrit.onap.org/r/policy/docker"
+
+
+The docker compose structure
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+After cloning the docker repository, the scripts and compose files are under the *compose/* folder.
+
+.. code-block:: bash
+
+ docker
+ compose
+ config -- all the components configurations
+ metrics -- configuration for Prometheus server and Grafana dashboards
+ docker-compose.gui.yml -- compose file with gui services
+ docker-compose.yml -- compose file with policy components services, including simulator, prometheus and grafana
+ export-ports.sh -- script to export the http ports for all components and where the images are collected from
+ get-versions.sh -- script to get the latest SNAPSHOT version of images based on branch (master is default)
+ start-compose.sh -- script to start the containers / applications
+ stop-compose.sh -- script to stop the containers / applications
+ wait_for_port.sh -- helper script to allow some wait time before an application is completely up and running
+
+
+Start the containers automatically
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Assuming all the scripts are being executed from the compose folder.
+
+To start all components without Policy GUI:
+
+.. code-block:: bash
+
+ ./start-compose.sh
+
+To start all components with Policy GUI:
+
+.. code-block:: bash
+
+ ./start-compose.sh --gui
+
+To start all components with Grafana dashboards and Prometheus server:
+
+.. code-block:: bash
+
+ ./start-compose.sh --grafana
+
+**You now have a full standalone ONAP Policy framework up and running!**
+
+To stop all containers, use stop-compose.sh
+
+.. code-block:: bash
+
+ ./stop-compose.sh