Discource-C
/
discourse
mirror of https://github.com/discourse/discourse.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

update install guide for Discourse 1.4

This commit is contained in:
Jeff Atwood 2015-09-23 03:16:03 -07:00
parent d4f5f0170c
commit c62c42185e
1 changed files with 16 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
docs/INSTALL-cloud.md
View File

@ -6,13 +6,13 @@
- Enter your domain `discourse.example.com` as the name. - Enter your domain `discourse.example.com` as the name.
- The default of **1 GB** RAM works fine for small Discourse communities. We do recommend 2 GB RAM for medium communities. - The default of **1 GB** RAM works fine for small Discourse communities. We recommend 2 GB RAM for larger communities.
- The default of **Ubuntu 14.04 LTS x64** works fine. At minimum, a 64-bit Linux OS with a kernel version of 3.10+ is required. - The default of **Ubuntu 14.04 LTS x64** works fine. At minimum, a 64-bit Linux OS with a kernel version of 3.10+ is required.
- The default of **New York** is a good choice for most US and European audiences. Or select a region that is geographically closer to your audience. - The default of **New York** is a good choice for most US and European audiences. Or select a region that is geographically closer to your audience.
Create your new Droplet. 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.) Create your new Droplet. You will receive an email 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.)
# Access Your Cloud Server # Access Your Cloud Server
@ -22,23 +22,20 @@ Connect to your Droplet via SSH, or use [Putty][put] on Windows:
Replace `192.168.1.1` with the IP address of your Droplet. Replace `192.168.1.1` with the IP address of your Droplet.
<img src="http://www.discourse.org/images/install/ssh-login-start-1-3-beta.png?v=1">
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. 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.
<img src="http://www.discourse.org/images/install/ssh-login-1-3-beta.png?v=1"> <img src="http://www.discourse.org/images/install/14/console-ssh.png?v=1">
# Set up Swap (if needed) # Set up Swap (if needed)
- If you're using the minimum 1 GB install, you *must* [set up a swap file](https://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880). - If you're using the minimum 1 GB install, you *must* [set up a swap file](https://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880).
- If you're using 2 GB+ memory, you can probably get by without a swap file. - If you're using 2 GB+ memory, you can probably get by without a swap file.
# Install Docker / Git # Install Docker / Git
wget -qO- https://get.docker.com/ | sh wget -qO- https://get.docker.com/ | sh
<img src="http://www.discourse.org/images/install/install-git-1-3-beta.png?v=1"> This command installs the latest versions of Docker and Git on your server. Alternately, you can manually install the respective [Docker package for your OS](https://docs.docker.com/installation/).
# Install Discourse # Install Discourse
@ -49,15 +46,15 @@ Create a `/var/discourse` folder, clone the [Official Discourse Docker Image][dd
cd /var/discourse cd /var/discourse
cp samples/standalone.yml containers/app.yml cp samples/standalone.yml containers/app.yml
<img src="http://www.discourse.org/images/install/mkdir-var-docker-1-3-beta.png?v=1"> <img src="http://www.discourse.org/images/install/14/console-clone-discourse.png?v=1">
# Edit Discourse Configuration # Edit Discourse Configuration
Edit the Discourse configuration at `app.yml`: Edit the Discourse config file `app.yml`:
nano containers/app.yml nano containers/app.yml
We recommend Nano because it works like a typical GUI text editor, just use your arrow keys. We recommend Nano because it's simple; just use your arrow keys to edit.
- Set `DISCOURSE_DEVELOPER_EMAILS` to your email address. - Set `DISCOURSE_DEVELOPER_EMAILS` to your email address.
@ -67,7 +64,7 @@ We recommend Nano because it works like a typical GUI text editor, just use your
- If you are using a 1 GB instance, set `UNICORN_WORKERS` to 2 and `db_shared_buffers` to 128MB so you have more memory room. - If you are using a 1 GB instance, set `UNICORN_WORKERS` to 2 and `db_shared_buffers` to 128MB so you have more memory room.
<img src="http://www.discourse.org/images/install/nano-screenshot-1-3-beta.png?v=1"> <img src="http://www.discourse.org/images/install/14/console-nano-app-yml.png?v=1">
After completing your edits, press <kbd>Ctrl</kbd><kbd>O</kbd> then <kbd>Enter</kbd> to save and <kbd>Ctrl</kbd><kbd>X</kbd> to exit. After completing your edits, press <kbd>Ctrl</kbd><kbd>O</kbd> then <kbd>Enter</kbd> to save and <kbd>Ctrl</kbd><kbd>X</kbd> to exit.
@ -93,33 +90,32 @@ After that completes, start Discourse:
./launcher start app ./launcher start app
<img src="http://www.discourse.org/images/install/launcher-start-app-1-3-beta.png?v=1"> <img src="http://www.discourse.org/images/install/14/console-launcher-start.png?v=1">
Congratulations! You now have your own instance of Discourse! 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`. 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`.
<img src="http://www.discourse.org/images/install/congratulations-on-installing-discourse-1-3-beta.png?v=1"> <img src="http://www.discourse.org/images/install/14/browser-installed-discourse.png?v=1">
# Register New Account and Become Admin # Register New Account and Become Admin
There is a reminder at the top about `DISCOURSE_DEVELOPER_EMAILS`; register a new account via one of those email addresses, and your account will automatically be made an Admin. There is a reminder at the top about the `DISCOURSE_DEVELOPER_EMAILS` you entered previously in `app.yml`; register a new account via one of those email addresses, and your account will automatically be made an Admin.
(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).) (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).)
<img src="http://www.discourse.org/images/install/discourse-installed-1-3-beta.png?v=1"> <img src="http://www.discourse.org/images/install/14/browser-logged-in-first-admin.png?v=1">
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. You should see Staff topics and the Admin Quick Start Guide. It contains the next steps for further configuring and customizing your Discourse install. Read it closely.
(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.) (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 # Post-Install Maintenance
We strongly suggest you: We strongly suggest you:
- turn on automatic security updates via the `dpkg-reconfigure -plow unattended-upgrades` command - turn on automatic security updates for your OS. In Ubuntu use the `dpkg-reconfigure -plow unattended-upgrades` command.
- enable stronger passwords via the `apt-get install libpam-cracklib` package - if you are using a password and not a SSH key, be sure to enforce a strong root password. In Ubuntu use the `apt-get install libpam-cracklib` package.
To **upgrade Discourse to the latest version**, visit `/admin/upgrade` and follow the instructions. To **upgrade Discourse to the latest version**, visit `/admin/upgrade` and follow the instructions.
@ -174,7 +170,7 @@ Do you want...
- To embed Discourse [in your WordPress install](https://github.com/discourse/wp-discourse), or [on your static HTML site](https://meta.discourse.org/t/embedding-discourse-comments-via-javascript/31963)? - To embed Discourse [in your WordPress install](https://github.com/discourse/wp-discourse), or [on your static HTML site](https://meta.discourse.org/t/embedding-discourse-comments-via-javascript/31963)?
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. Help us improve this guide! Feel free to ask about it on [meta.discourse.org][meta], or even better, submit a pull request.
[dd]: https://github.com/discourse/discourse_docker [dd]: https://github.com/discourse/discourse_docker
[man]: https://mandrillapp.com [man]: https://mandrillapp.com