From 3ee7ef09533a83b45655c225d4ce03f9fe1b0f07 Mon Sep 17 00:00:00 2001 From: Jeff Atwood <jatwood@codinghorror.com> Date: Tue, 25 Feb 2014 01:11:32 -0800 Subject: [PATCH] normalize on Docker installs --- docs/INSTALL.md | 50 +++++++++++++++++++------------------------------ 1 file changed, 19 insertions(+), 31 deletions(-) diff --git a/docs/INSTALL.md b/docs/INSTALL.md index 5dead8441..f2e181b0e 100644 --- a/docs/INSTALL.md +++ b/docs/INSTALL.md @@ -1,46 +1,34 @@ # How Do I Install Discourse? -It is still early times for Discourse. From [our FAQ](http://www.discourse.org/faq/): +If you want the easiest possible install: +[**Beginner Docker install guide for Digital Ocean**][do] -> Discourse is brand new. Discourse is early beta software, and likely to remain so for many months. -> Please experiment with it, play with it, give us feedback, submit pull requests – but any consideration -> of fully adopting Discourse is for people and organizations who are eager to live on the bleeding and broken edge. +If you want a powerful, flexible install: +[**Advanced Docker install guide**][docker] -Still interested? +The only officially supported installs of Discourse are the [Docker](https://www.docker.io/) based beginner and advanced installs, above. We regret that we cannot directly support any other methods of installation. -### [**Click here for the OFFICIAL INSTALL GUIDE**][1] +Alternately, you can try the [unofficial Heroku install guide][heroku], the [unofficial Ubuntu install guide][ubuntu], the [BitNami Discourse Virtual Machine package][bitnami] or [Cloud66][cloud66]. -Alternately, you can try the [unofficial Heroku install guide][2], the [BitNami Discourse Virtual Machine package][3] or [Cloud66][4]. - -## Quick and Dirty Install +## Requirements ### Hardware - Dual core CPU recommended -- 2 GB RAM recommended (and 2 GB of swap space) +- 2 GB RAM recommended + +We highly recommend you enable swap (for a total of 4 GB, so 2 GB swap with 2 GB RAM, and 3 GB swap with 1 GB ram, etc). ### Software -1. **Postgres 9.1+** - - Enable support for HSTORE - - Create a discourse database and seed it with a basic image +1. [Postgres 9.1+](http://www.postgresql.org/download/) +2. [Redis 2.6+](http://redis.io/download) +3. [Ruby 1.9.3+](http://www.ruby-lang.org/en/downloads/) (we recommend 2.0.0-p353 or higher) -2. **Redis 2.6+** -3. **Ruby 1.9.3+** (we recommend 2.0.0-p195 or higher) - - Install all rubygems via bundler - - Edit database.yml and redis.yml and point them at your databases. - - Run `rake db:seed_fu` to add seed data - - Prepackage all assets using rake - - Run the Rails database migrations - - Run a sidekiq process for background jobs - - Run several Rails processes, preferably behind a proxy like Nginx. - -### Low memory (less than 2 GB) - -Remember you *will* need swap enabled (enough for a total of 4 GB, so 2 GB swap with 2 GB RAM, and 3 GB swap with 1 GB ram, etc) and working! - -[1]: https://github.com/discourse/discourse/blob/master/docs/INSTALL-ubuntu.md -[2]: https://github.com/discourse/discourse/blob/master/docs/HEROKU.md -[3]: http://bitnami.com/stack/discourse -[4]: https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud66.md +[do]: https://github.com/discourse/discourse/blob/master/docs/INSTALL-digital-ocean.md +[docker]: https://github.com/discourse/discourse_docker +[bitnami]: http://bitnami.com/stack/discourse +[cloud66]: https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud66.md +[heroku]: https://github.com/discourse/discourse/blob/master/docs/install-HEROKU.md +[ubuntu]: https://github.com/discourse/discourse/blob/master/docs/INSTALL-ubuntu.md