diff --git a/docs/getting-started/install/azure.md b/docs/getting-started/install/azure.md new file mode 100644 index 00000000000..6f66012d004 --- /dev/null +++ b/docs/getting-started/install/azure.md @@ -0,0 +1,11 @@ +# Microsoft Azure + +- If you don't already have one [generate an SSH key pair](https://help.github.com/articles/generating-ssh-keys/). + +- Go to the [dokku on azure deployment page](https://azure.microsoft.com/en-us/documentation/templates/dokku-vm/) and click **Deploy to Azure**. + +- You'll be prompted to enter a few parameters, including a unique storage account name and a unique name for the sub-domain used for your public IP address. For the `sshKeyData` parameter, copy and paste the contents of the **public** key file you just created. After a few minutes the Dokku instance will be deployed. + +- In your browser of choice, navigate to `http://[[dnsNameForPublicIP]].[[location]].cloudapp.azure.com`. Where `[[dnsNameForPublicIP]]` and `[[location]]` are template parameters you used to deploy the template. + +- Finish your dokku setup like you normally would by creating a **new** public/private key pair for your deployments using `ssh-keygen` (don't use the same one as you created in the first step). You should select 'Use Virtual Host Naming' and set the `Hostname` to a **public dns name** that you own such as one you would purchase from [namecheap](http://namecheap.com). Alternatively thanks to [xip.io]( http://xip.io/) you can just use yourAzurePublicIP.xip.io for free. For example, if your public IP is `44.44.44.44` then you would set it to `44.44.44.44.xip.io`. diff --git a/docs/installation.md b/docs/installation.md index 4e155867270..a49604826d3 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -34,7 +34,8 @@ Once you save your settings, the web admin will self-terminate and you should be For various reasons, certain hosting providers may have other steps that should be preferred to the above. If hosted on any of the following popular hosts, please follow the linked to instructions: - [Digital Ocean Installation Notes](http://progrium.viewdocs.io/dokku/getting-started/install/digitalocean) -- [Linode Installation Notes](http://progrium.viewdocs.io/dokku/getting-started/install/linode) +- [Linode Installation Notes](http://progrium.viewdocs.io/dokku/getting-started/install/linode/) +- [Microsoft Azure Installation Notes](http://progrium.viewdocs.io/dokku/getting-started/install/azure/) As well, you may wish to customize your installation in some other fashion. or experiment with vagrant. The guides below should get you started: