Add tips for Ubuntu 18.04 and Azure (#325)
diff --git a/README.md b/README.md
index dc7a778..d55268d 100644
--- a/README.md
+++ b/README.md
@@ -72,6 +72,8 @@
* Install [Ansible for Azure](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ansible-install-configure) within
the Python virtual environment by using `pip install ansible[azure]`
+When running Muchos under Ubuntu 18.04, checkout these [tips](docs/azure-ubuntu-1804.md).
+
## Quickstart
The following commands will install Muchos, launch a cluster, and setup/run Accumulo:
diff --git a/docs/azure-ubuntu-1804.md b/docs/azure-ubuntu-1804.md
new file mode 100644
index 0000000..dcdebce
--- /dev/null
+++ b/docs/azure-ubuntu-1804.md
@@ -0,0 +1,19 @@
+Tips for running Muchos for Azure under Ubuntu 18.04
+----------------------------------------------------
+
+Muchos sets up a Centos cluster, but it does not have to run in Centos. If you
+wish to run Muchos under Ubuntu 18.04 and have it set up an Azure cluster, then
+the following steps can get you on your way.
+
+```bash
+# Install azure cli. See the Azure documentation.
+# https://docs.microsoft.com/en-us/cli/azure/install-azure-cli-apt?view=azure-cli-latest
+
+# Install Ansible Azure for Python 3. The main reason these tips were written
+# was to save you time on the following steps. Muchos uses Python 3. If
+# python-pip and pip were installed and used, those would go against Python 2
+# and would not work.
+sudo apt install python3-pip
+sudo pip3 install ansible[azure]
+```
+
