1-gui/README.md

+# Graphical User Interface
+
+For basic instructions on how to start a virtual machine instance, see [Quick Start](/0-quick-start/README.md).
+
+## Create Network
+
+1. Go to **Project > Network > Networks**, click on **Create Network**.
+
+2. Choose name and click **Next**.
+
+3. In the subnet tab, choose a subnet name. In **Network Address Source**, select **Allocate Network Addres from a pool**.
+   In **Address pool** select any of the available pools. Click **Next**.
+
+4. Click **Create**. Do not change any other options.
+
+5. Go to **Project > Network > Network Topology**, review your newly created network topology.
+
+  ![](/1-gui/images/network5.png)
+
+## Create Router
+
+1. Go to **Project > Network > Routers**, click on the **Create Router** button.
+
+2. Choose a name. Select **External Network** and click **Create Router**.
+
+  <div style="border-width:0;border-left:5px solid #b8d6f4;background-color:rgba(228,240,251,0.3);margin:20px 0;padding:10px 20px;font-size:15px;">
+    <strong>Notice:</strong><br/>
+    Please, remember that your will have to allocate floating IP addresses in the selected External Network for all instances
+    using this router as a gateway.
+  </div>
+
+3. Go to **Project &gt; Network &gt; Network Topology**, the newly create router should be now present.
+
+  ![](/1-gui/images/router3.png)
+
+4. Click on the router icon, select **Add Interface**.
+
+  ![](/1-gui/images/router4.png)
+
+5. Choose the previously created network/subnet from the drop-down menu. Click **Submit**.
+
+  ![](/1-gui/images/router5.png)
+
+6. The router is now attached to an external network.
+
+  ![](/1-gui/images/router6.png)
+
+  <div style="border-width:0;border-left:5px solid #b8d6f4;background-color:rgba(228,240,251,0.3);margin:20px 0;padding:10px 20px;font-size:15px;">
+    <strong>Notice:</strong><br/>
+    Routers can also be used to route traffic between internal networks. This is an advanced topic not covered in this guide.
+  </div>

2-cli/README.md

+# Command Line Interface
+
+In order to have access to OpenStack's API, you have to use so-called OpenStack Application Credentials. In short,
+it is a form of token-based authentication providing easy and secure access without the use of passwords.
+
+## Getting Credentials
+1. In **Identity > Application Credentials**, click on **Create Application Credential**.
+2. Choose name, description and expiration date & time.
+
+  ![](/2-cli/images/app_creds_1.png)
+
+  <div style="border-width:0;border-left:5px solid #b8d6f4;background-color:rgba(228,240,251,0.3);margin:20px 0;padding:10px 20px;font-size:15px;">
+    <strong>Notice:</strong><br/>
+    Do NOT select specific roles, unless directed otherwise by user support.
+  </div>
+
+  <div style="border-width:0;border-left:5px solid #b8d6f4;background-color:rgba(228,240,251,0.3);margin:20px 0;padding:10px 20px;font-size:15px;">
+    <strong>Notice:</strong><br/>
+    If you decide to select specific roles, you should always include at least the <strong>member</strong> role.
+    If you are planning to use the orchestration API, add the <strong>heat_stack_owner</strong> role as well.
+  </div>
+
+3. Download provided configuration files for the OpenStack CLI client.
+
+  ![](/2-cli/images/app_creds_2.png)
+
+## Setting Up
+1. [Install](https://pypi.org/project/python-openstackclient/) and
+   [configure](https://docs.openstack.org/python-openstackclient/rocky/configuration/index.html)
+   OpenStack CLI client.
+
+   <div style="border-width:0;border-left:5px solid #b8d6f4;background-color:rgba(228,240,251,0.3);margin:20px 0;padding:10px 20px;font-size:15px;">
+     <strong>Notice:</strong><br/><br/>
+     Add the following line to the <strong>openrc</strong> file:<br/>
+     <strong>export OS_VOLUME_API_VERSION=3</strong>
+     <br/><br/>
+     Add the following line to the <strong>clouds.yaml</strong> file:<br/>
+     <strong>volume_api_version: 3</strong>
+   </div>
+
+2. Follow the official [Launch instances](https://docs.openstack.org/nova/rocky/user/launch-instances.html) guide.
+
+## Full Reference
+See [OpenStack CLI Documentation](https://docs.openstack.org/python-openstackclient/rocky/).