3 files changed, 53 insertions, 3 deletions
diff --git a/docs/configuration/system/ip.rst b/docs/configuration/system/ip.rst
index 6c158de9..361e9f6d 100644
--- a/docs/configuration/system/ip.rst
+++ b/docs/configuration/system/ip.rst
@@ -32,7 +32,7 @@ show commands
 
 See below the different parameters available for the IPv4 **show** command:
 
-.. code-block::
+.. code-block:: none
 
    vyos@vyos:~$ show ip
    Possible completions:
@@ -64,7 +64,7 @@ reset commands
 
 And the different IPv4 **reset** commands available:
 
-.. code-block::
+.. code-block:: none
 
    vyos@vyos:~$ reset ip 
    Possible completions:
diff --git a/docs/installation/cloud/cloud-init.rst b/docs/installation/cloud/cloud-init.rst
new file mode 100644
index 00000000..1a5bda92
--- /dev/null
+++ b/docs/installation/cloud/cloud-init.rst
@@ -0,0 +1,48 @@
+.. _cloud-init: 
+ 
+################################ 
+Configuring Vyos with cloud-init 
+################################ 
+
+Vyos uses cloud-init to configure itself automatically in cloud environments.
+There is a Meta-Data module ``cc_vyos.py`` that takes care of the
+cloud-specific configuration.
+
+Additional module ``cc_vyos_userdata.py`` introduces a new parameter
+``vyos_config_commands`` into User-Data (``#cloud-config``). This parameter
+should be a list of VyOS configuration commands that will be applied during
+deployment. This module will run last.
+
+Commands requirements:
+
+   * one command per line
+   * if command ending by value, it must be inside single quotes:
+     ``set some option 'value'``, ``delete some option 'value'``
+   * a single-quote symbol is not allowed inside command or value
+
+The commands list produced by the ``show configuration commands`` command on a
+VyOS router should comply with all the requirements, so it is easy to get a
+proper commands list by copying it from another router.
+
+Usage example (User-Data content):
+
+.. code-block:: none
+
+   #cloud-config
+   vyos_config_commands:
+   - set system host-name 'demo123'
+   - set system ntp server 1.pool.ntp.org
+   - set system ntp server 2.pool.ntp.org
+   - delete interfaces ethernet eth2 address
+   - set interfaces ethernet eth2 address '192.0.2.1/24'
+
+
+
+References
+----------
+
+.. stop_vyoslinter
+
+https://github.com/vyos/vyos-cloud-init/commit/1607eec32641ad93ea211e447336b3366c28de06
+
+.. start_vyoslinter
diff --git a/docs/installation/cloud/index.rst b/docs/installation/cloud/index.rst
index f6060762..860122f5 100644
--- a/docs/installation/cloud/index.rst
+++ b/docs/installation/cloud/index.rst
@@ -5,5 +5,7 @@ Running VyOS in Cloud Environments
 
 
 .. toctree::
+   :maxdepth: 1
    :caption: Content
-
+   
+   cloud-init