From e960d67d70f78f7e528261b3c7b2c90c26ebc679 Mon Sep 17 00:00:00 2001 From: Jeff Atwood Date: Thu, 17 Apr 2014 15:12:46 -0700 Subject: [PATCH] update final screenshot, add email section --- docs/INSTALL-digital-ocean.md | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/docs/INSTALL-digital-ocean.md b/docs/INSTALL-digital-ocean.md index cd810312416..6b4dd45a911 100644 --- a/docs/INSTALL-digital-ocean.md +++ b/docs/INSTALL-digital-ocean.md @@ -64,33 +64,35 @@ Copy the `samples/standalone.yml` file into the `containers` folder as `app.yml` cp samples/standalone.yml containers/app.yml - - # Edit Discourse Configuration -Edit `app.yml`: +Edit the Discourse configuration at `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 choose whatever text editor you like.) +We recommend Nano because it works like a typical GUI text editor, just use your arrow keys. -- Set `DISCOURSE_DEVELOPER_EMAILS` and `DISCOURSE_HOSTNAME`. +- Set `DISCOURSE_DEVELOPER_EMAILS` + +- Set `DISCOURSE_HOSTNAME` to `discourse.example.com`, this means you want your Discourse available at `http://discourse.example.com/`. You'll need to update the DNS A record for this domain with the IP address of your server. + +- Place your mail credentials in `DISCOURSE_SMTP_ADDRESS`, `DISCOURSE_SMTP_PORT`, `DISCOURSE_SMTP_USER_NAME`, `DISCOURSE_SMTP_PASSWORD`. Be sure you remove the comment `#` character and space from the front of these lines as necessary. - If you are using a 1 GB instance, set `UNICORN_WORKERS` to 2 so you have more memory room. -If you set `DISCOURSE_HOSTNAME` to `discourse.example.com`, this means you want your Discourse available at `http://discourse.example.com/`. You'll need to update the DNS A record for this domain with the IP address of your server. +After completing your edits, press CtrlO then Enter to save and CtrlX to exit. + +# Email **Email is critical to notifications in Discourse. If you do not configure email before bootstrapping you will have a broken site!** -- If you already have a mail server, put your existing mail server credentials in the `app.yml` file. +- Already have a mail server? Great. Use your existing mail server credentials. -- Otherwise, create a free account on [**Mandrill**][man] (or [Mailgun][gun], or [Mailjet][jet]), and put your mail 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`. +- No existing mail server, or you don't know what it is? No problem, create a free account on [**Mandrill**][man] (or [Mailgun][gun], or [Mailjet][jet]), and use the credentials provided in the dashboard. -- Be sure you remove the comment character and space `# ` from the beginning of these mail configuration lines! - -- Don't forget to set the [SPF and DKIM records](http://help.mandrill.com/entries/21751322-What-are-SPF-and-DKIM-and-do-I-need-to-set-them-up-) up for your domain name. In Mandrill, that's under Sending Domains, View DKIM/SPF setup instructions. +- For proper email deliverability, you must set the [SPF and DKIM records](http://help.mandrill.com/entries/21751322-What-are-SPF-and-DKIM-and-do-I-need-to-set-them-up-) in your DNS. In Mandrill, that's under Sending Domains, View DKIM/SPF setup instructions. # Bootstrap Discourse @@ -110,7 +112,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` earlier. - + You can also access it by visiting the server IP address directly, e.g. `http://192.168.1.1`.