diff --git a/doc/common/section_docker.xml b/doc/common/section_docker.xml
new file mode 100644
index 0000000000..0b9e50333a
--- /dev/null
+++ b/doc/common/section_docker.xml
@@ -0,0 +1,41 @@
+
+
+ Docker Driver
+ The Docker driver is a hypervisor driver for OpenStack Compute,
+ introduced with the Havana release. Docker is an open-source engine which
+ automates the deployment of applications as highly portable, self-sufficient
+ containers which are independent of hardware, language, framework, packaging
+ system and hosting provider. Docker extends LXC with a high level API
+ providing a lightweight virtualization solution that runs processes in
+ isolation. It provides a way to automate software deployment in a secure and
+ repeatable environment. A standard container in Docker contains a software
+ component along with all of its dependencies - binaries, libraries,
+ configuration files, scripts, virtualenvs, jars, gems and tarballs. Docker
+ can be run on any x86_64 Linux kernel that supports cgroups and aufs. Docker
+ is a way of managing LXC containers on a single machine. However used behind
+ OpenStack Compute makes Docker much more powerful since it’s then possible
+ to manage several hosts which will then manage hundreds of containers. The
+ current Docker project aims for full OpenStack compatibility. Containers
+ don't aim to be a replacement for VMs, they are just complementary in the
+ sense that they are better for specific use cases. Compute's support for VMs
+ is currently advanced thanks to the variety of hypervisors running VMs.
+ However it's not the case for containers even though libvirt/LXC is a good
+ starting point. Docker aims to go the second level of integration.
+
+ Some OpenStack Compute features are not implemented by
+ the docker driver. See the
+ hypervisor support matrix for details.
+
+ To enable Docker, ensure the following options are set in
+ /etc/nova/nova.conf on all hosts running the
+ nova-compute service.
+ compute_driver=docker.DockerDriver
+ Glance also needs to be configured to support the Docker container format, in
+ /etc/glance-api.conf:
+ container_formats = ami,ari,aki,bare,ovf,docker
+
+
diff --git a/doc/config-reference/compute/section_compute-hypervisors.xml b/doc/config-reference/compute/section_compute-hypervisors.xml
index 94b7a4d749..0e1df48e59 100644
--- a/doc/config-reference/compute/section_compute-hypervisors.xml
+++ b/doc/config-reference/compute/section_compute-hypervisors.xml
@@ -86,6 +86,14 @@
hardware through pluggable sub-drivers (for example, PXE for image
deployment, and IPMI for power management).
+
+ Dockeris an open-source engine which automates the deployment of
+ >applications as highly portable, self-sufficient containers which are
+ >independent of hardware, language, framework, packaging system and hosting
+ >provider.
+ Hypervisor Configuration Basics
@@ -113,4 +121,5 @@
+