diff --git a/doc/source/contributor/automated.rst b/doc/source/contributor/automated.rst
index 5eb212638e7b247a5a85a3f4a0647d52715ca1b8..35ea0c3f0dfad21c2bab7eda3541c9539d1963c2 100644
--- a/doc/source/contributor/automated.rst
+++ b/doc/source/contributor/automated.rst
@@ -62,6 +62,14 @@ Clone the ``kayobe-config-dev`` repository to ``config/src/kayobe-config``
 Inspect the Kayobe configuration and make any changes necessary for your
 environment.
 
+If you want to test bare metal compute nodes as described in
+:ref:`testing_bare_metal_compute`, enable Ironic by adding the following to
+``config/src/kayobe-config/etc/kayobe/kolla.yml``:
+
+.. code-block:: yaml
+
+   kolla_enable_ironic: True
+
 If using Vagrant, follow the steps in :ref:`contributor-vagrant` to prepare
 your environment for use with Vagrant and bring up a Vagrant VM.
 
@@ -124,6 +132,8 @@ virtual server instance, and delete it once it becomes active::
 
     ./dev/overcloud-test-vm.sh
 
+.. _testing_bare_metal_compute:
+
 Bare Metal Compute
 ^^^^^^^^^^^^^^^^^^