From aaf83f14105284b114955a159ddd76a3bfc763f7 Mon Sep 17 00:00:00 2001 From: Jeff Atwood Date: Sun, 23 Feb 2014 09:38:06 -0800 Subject: [PATCH] clean up guide, add mailgun/mailjet opt --- docs/INSTALL-digital-ocean.md | 29 +++++++++++++++++------------ 1 file changed, 17 insertions(+), 12 deletions(-) diff --git a/docs/INSTALL-digital-ocean.md b/docs/INSTALL-digital-ocean.md index 759fc3938cc..9de9efdd5a5 100644 --- a/docs/INSTALL-digital-ocean.md +++ b/docs/INSTALL-digital-ocean.md @@ -4,27 +4,29 @@ The below guide assumes that you have no knowledge of Ruby/Rails or Linux shell, # Create New Digital Ocean Droplet -Discourse recommends a minimum of 1 GB Ram, so that's what we will go with. We'll use discourse as the Hostname. +Discourse recommends a minimum of 1 GB RAM. We'll use "discourse" as the Hostname. -We will install Discourse on Ubuntu 12.04.3 LTS x64. We always recommend using [the current LTS distribution][lts]. +Install Discourse on Ubuntu 12.04.3 LTS x64. We always recommend using [the current LTS distribution][lts]. -Once you complete the above steps you will receive a mail from Digital Ocean with the root password to the Droplet. (However, if you use SSH keys, you may not need a password to log in.) +You will receive a mail from Digital Ocean with the root password to your Droplet. (However, if you use SSH keys, you may not need a password to log in.) # Access Your Droplet -Type the following command in your terminal: +Connect to your Droplet via SSH: ssh root@192.168.1.1 -Replace `192.168.1.1` with the IP address you got from Digital Ocean. +(Alternately, use [Putty][put] on Windows) + +Replace `192.168.1.1` with the IP address of your Droplet. -It will ask your permission to connect, type `yes`, then it will ask for the root password, which was in the email Digital Ocean sent you when the Droplet was set up. Enter it. +It will ask your permission to connect, type `yes`, then it will ask for the root password, which is in the email Digital Ocean sent you when the Droplet was set up. Enter it. @@ -91,7 +93,7 @@ Modify this newly copied `app.yml`: nano containers/app.yml -(We recommend Nano because it works like a typical GUI text editor, just use your arrow keys. Hit CtrlO then Enter to save and CtrlX to exit. However, feel free to use whatever text editor you like. In the below screenshot we use Vim.) +(We recommend Nano because it works like a typical GUI text editor, just use your arrow keys. Hit CtrlO then Enter to save and CtrlX to exit. However, feel free to choose whatever text editor you like. In the below screenshot we use Vim.) @@ -99,17 +101,17 @@ Modify the file as desired, but at minimum you should set `DISCOURSE_DEVELOPER_E -Notice that I renamed `DISCOURSE_HOSTNAME` to `discourse.techapj.com`, this means that I want to host my instance of Discourse on `http://discourse.techapj.com/`. You'll need to modify your DNS records to reflect the IP address and preferred domain name of your server. +I renamed `DISCOURSE_HOSTNAME` to `discourse.techapj.com`, this means that I want to host my instance of Discourse on `http://discourse.techapj.com/`. You'll need to modify your DNS records to reflect the IP address and preferred domain name of your server. -#Mail Setup +# Mail Setup **Email is critical to Discourse. We strongly recommend configuring mail settings before bootstrapping.** - If you already have a mail server, put your existing mail server credentials in the `app.yml` file. -- Otherwise, create a free account on [**Mandrill**][man], and put your Mandrill credentials (available via the Mandrill dashboard) in the `app.yml` file. The settings you want to change are `DISCOURSE_SMTP_ADDRESS`, `DISCOURSE_SMTP_PORT`, `DISCOURSE_SMTP_USER_NAME`, `DISCOURSE_SMTP_PASSWORD`. +- Otherwise, create a free account on [**Mandrill**][man] (or [Mailgun][gun], or [Mailjet][jet]), and put your Mandrill credentials (available via the Mandrill dashboard) in the `app.yml` file. The settings you want to change are `DISCOURSE_SMTP_ADDRESS`, `DISCOURSE_SMTP_PORT`, `DISCOURSE_SMTP_USER_NAME`, `DISCOURSE_SMTP_PASSWORD`. -#Add Your SSH Key +# Add Your SSH Key If you successfully generated the SSH key as described earlier, get it: @@ -133,7 +135,7 @@ After that completes, start Discourse: -Congratulations! You now have your own instance of Discourse, accessible via the domain name you entered in `app.yml` file at the time of setup. +Congratulations! You now have your own instance of Discourse, accessible via the domain name you entered in `app.yml` earlier. @@ -163,3 +165,6 @@ If anything needs to be improved in this guide, feel free to ask on [meta.discou [meta]: https://meta.discourse.org [do]: https://www.digitalocean.com/ [lts]: https://wiki.ubuntu.com/LTS + [jet]: http://www.mailjet.com/pricing + [gun]: http://www.mailgun.com/ + [put]: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html