Documentation: enable all additional container

README.md

@@ -269,6 +269,36 @@ Furthermore PHP 5.2 does only work with Apache 2.4, Nginx stable and Nginx mainl
 > **Documentation:**
 > [Change container versions](https://devilbox.readthedocs.io/en/latest/getting-started/change-container-versions.html)
 
+#### Additional services
+
+Additionally to the default stack, there are a variety of other services that can be easily enabled and started.
+
+<table>
+ <thead>
+  <tr>
+   <th>MailHog</th>
+   <th>RabbitMQ</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>v1.0.0</td>
+   <td>3.6</td>
+  </tr>
+  <tr>
+   <td>latest</td>
+   <td>3.7</td>
+  </tr>
+  <tr>
+   <td></td>
+   <td>latest</td>
+  </tr>
+ </tbody>
+</table>
+
+> **Documentation:**
+> [Enable custom container](https://devilbox.readthedocs.io/en/latest/custom-container/enable-all-container.html)
+
 
 #### Enter the container
 

docs/_includes/snippets/additional-container.rst

@@ -0,0 +1,7 @@
++---------------------------+----------+----------+----------------+
+| Container                 | Name     | Hostname | IP Address     |
++===========================+==========+==========+================+
+| MailHog                   | mailhog  | mailhog  | 172.16.238.200 |
++---------------------------+----------+----------+----------------+
+| RabbitMQ                  | rabbit   | rabbit   | 172.16.238.210 |
++---------------------------+----------+----------+----------------+

docs/custom-container/enable-all-container.rst

@@ -0,0 +1,57 @@
+.. include:: /_includes/all.rst
+
+.. _custom_container_enable_all_additional_container:
+
+*******************************
+Enable all additional container
+*******************************
+
+Besides providing basic LAMP/MEAN stack container, which are well integrated into the Devilbox
+intranet, the Devilbox also ships additional pre-configured container that can easily be enabled.
+
+
+**Table of Contents**
+
+.. contents:: :local:
+
+
+Available additional container
+==============================
+
+The following table shows you the currently additional available container:
+
+.. include:: /_includes/snippets/additional-container.rst
+
+
+Enable all additional container
+===============================
+
+Copy ``docker-compose.override.yml-all`` into the root of the Devilbox git directory.
+
+.. code-block:: bash
+
+   host> cp compose/docker-compose.override.yml-all docker-compose.override.yml
+
+That's it, if you ``docker-compose up``, all container will be started. This however is not
+adviced as it will eat up a lot of resources. You are better off by selectively specifying the
+container you want to run.
+
+.. seealso:: :ref:`start_the_devilbox`
+
+
+Configure additional container
+=============================
+
+The additional container also provide many configuration options just as the default ones do.
+That includes, but is not limited to:
+
+* Image version
+* Exposed ports
+* Mount points
+* And various container specific settings
+
+In order to fully customize each container, refer to their own documentation section:
+
+.. seealso::
+   * :ref:`custom_container_enable_mailhog`
+   * :ref:`custom_container_enable_rabbitmq`

docs/readings/available-container.rst

@@ -40,21 +40,14 @@ These container are well integrated into the Devilbox intranet and are considere
 Additional container
 ====================
 
-Additional container that are not yet integrated into the Devilbox intranet and are less
-frequently used are also available.
+Additional container that are not yet integrated into the Devilbox intranet are also available.
 Those container come via ``docker-compose.override.yml`` and must explicitly be enabled.
 They are disabled by default to prevent accidentally starting too many container and making your
 computer unresponsive.
 
-+---------------------------+----------+----------+----------------+
-| Container                 | Name     | Hostname | IP Address     |
-+===========================+==========+==========+================+
-| MailHog                   | mailhog  | mailhog  | 172.16.238.200 |
-+---------------------------+----------+----------+----------------+
-| RabbitMQ                  | rabbit   | rabbit   | 172.16.238.210 |
-+---------------------------+----------+----------+----------------+
+.. include:: /_includes/snippets/additional-container.rst
 
 .. seealso::
-   * :ref:`custom_container_enable_all_container`
+   * :ref:`custom_container_enable_all_additional_container`
    * :ref:`custom_container_enable_mailhog`
    * :ref:`custom_container_enable_rabbitmq`