From e66f1eeb5c5bc89e060ffa131a060981a7f33f80 Mon Sep 17 00:00:00 2001 From: Arpit Jalan Date: Sun, 6 Jul 2014 22:00:43 +0530 Subject: [PATCH] Add create admin instructions in install guide --- docs/INSTALL-digital-ocean.md | 36 ++++++++++++++++++----------------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/docs/INSTALL-digital-ocean.md b/docs/INSTALL-digital-ocean.md index 60e05072975..97802dc787a 100644 --- a/docs/INSTALL-digital-ocean.md +++ b/docs/INSTALL-digital-ocean.md @@ -4,13 +4,13 @@ [Sign up for Digital Ocean][do], update billing info, then begin creating your new cloud server (Droplet). -Use the URL of your new site as the Droplet hostname, e.g. `discourse.example.com`. Discourse requires a minimum of **1 GB RAM** for small communities; we recommend 2 GB RAM for medium communities. +Use the URL of your new site as the Droplet hostname, e.g. `discourse.example.com`. Discourse requires a minimum of **1 GB RAM** for small communities; we recommend 2 GB RAM for medium communities. - + Install Discourse on Ubuntu 14.04 LTS x64. Always select [the latest LTS distribution][lts]. - + You will receive a mail from Digital Ocean with the root password to your Droplet. (However, if you know [how to use SSH keys](https://www.google.com/search?q=digitalocean+ssh+keys), you may not need a password to log in.) @@ -22,11 +22,11 @@ Connect to your Droplet via SSH, or use [Putty][put] on Windows: Replace `192.168.1.1` with the IP address of your Droplet. - + You will be asked for permission to connect, type `yes`, then enter the root password from the email Digital Ocean sent you when the Droplet was set up. You may be prompted to change the root password, too. - + # Set up Swap (if needed) @@ -38,13 +38,13 @@ You will be asked for permission to connect, type `yes`, then enter the root pas apt-get install git - + # Install Docker wget -qO- https://get.docker.io/ | sh - + # Install Discourse @@ -64,7 +64,7 @@ Copy the `samples/standalone.yml` file into the `containers` folder as `app.yml` cp samples/standalone.yml containers/app.yml - + # Edit Discourse Configuration @@ -75,14 +75,14 @@ Edit the Discourse configuration at `app.yml`: We recommend Nano because it works like a typical GUI text editor, just use your arrow keys. - Set `DISCOURSE_DEVELOPER_EMAILS` to your email address. - + - 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. - + After completing your edits, press CtrlO then Enter to save and CtrlX to exit. @@ -104,7 +104,7 @@ Save the `app.yml` file, and begin bootstrapping Discourse: This command can take up to 8 minutes. It is automagically configuring your Discourse environment. - + After that completes, start Discourse: @@ -114,7 +114,7 @@ Congratulations! You now have your own instance of Discourse! It should be accessible via the domain name `discourse.example.com` you entered earlier, provided you configured DNS. If not, you can also visit the server IP directly, e.g. `http://192.168.1.1`. - + # Register New Account and Become Admin @@ -122,10 +122,12 @@ There is a reminder at the top about `DISCOURSE_DEVELOPER_EMAILS`; register a ne (If you *don't* get any email from your install, and are unable to register a new admin account, please see our [Email Troubleshooting checklist](https://meta.discourse.org/t/troubleshooting-email-on-a-new-discourse-install/16326).) - + You should see Staff topics and the [Admin Quick Start Guide](https://github.com/discourse/discourse/blob/master/docs/ADMIN-QUICK-START-GUIDE.md). It contains the next steps for further configuring and customizing your Discourse install. +(If you are still unable to register a new admin account via email, see [Create Admin Account from Console](https://meta.discourse.org/t/create-admin-account-from-console/17274), but please note that *you will have a broken site* unless you get email working on your instance.) + # Post-Install Maintenance @@ -163,11 +165,11 @@ Do you want... - Users to post reples via email? [Configure reply via email](https://meta.discourse.org/t/set-up-reply-via-email-support/14003). - Automatic daily backups? [Configure backups](https://meta.discourse.org/t/configure-automatic-backups-for-discourse/14855). - + - HTTPS / SSL support? [Configure SSL](https://meta.discourse.org/t/allowing-ssl-for-your-discourse-docker-setup/13847). - + - Multiple Discourse sites on the same server? [Configure multisite](https://meta.discourse.org/t/multisite-configuration-with-docker/14084). - + - A Content Delivery Network to speed up worldwide access? [Configure a CDN](https://meta.discourse.org/t/enable-a-cdn-for-your-discourse/14857). If anything needs to be improved in this guide, feel free to ask on [meta.discourse.org][meta], or even better, submit a pull request.