discourse/docs/INSTALL.md

# How Do I Install Discourse?

If you want the easiest possible install:  
[**Beginner Docker install guide for Digital Ocean**][do]

If you want a powerful, flexible install:  
[**Advanced Docker install guide**][docker]

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.

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].

## Requirements

### Hardware

- Dual core CPU recommended
- 2 GB RAM *strongly* recommended
 
We also recommend you [enable swap][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

- [Postgres 9.1+](http://www.postgresql.org/download/)
- [Redis 2.6+](http://redis.io/download)
- [Ruby 1.9.3+](http://www.ruby-lang.org/en/downloads/) (we recommend 2.0.0-p353 or higher)


[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
[swap]: https://www.digitalocean.com/community/articles/how-to-add-swap-on-ubuntu-12-04
copyedits 2013-07-31 05:48:40 +08:00			`# How Do I Install Discourse?`
Initial release of Discourse 2013-02-06 03:16:51 +08:00
normalize on Docker installs 2014-02-25 17:11:32 +08:00			`If you want the easiest possible install:`
			`[Beginner Docker install guide for Digital Ocean][do]`
Initial release of Discourse 2013-02-06 03:16:51 +08:00
normalize on Docker installs 2014-02-25 17:11:32 +08:00			`If you want a powerful, flexible install:`
			`[Advanced Docker install guide][docker]`
Initial release of Discourse 2013-02-06 03:16:51 +08:00
normalize on Docker installs 2014-02-25 17:11:32 +08:00			`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.`
add link to official-ish install docs 2013-06-08 06:57:55 +08:00
normalize on Docker installs 2014-02-25 17:11:32 +08:00			`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].`
three main pre-reqs 2013-06-08 07:00:01 +08:00
normalize on Docker installs 2014-02-25 17:11:32 +08:00			`## Requirements`
update install doc 2013-07-31 05:42:07 +08:00
			`### Hardware`
add hardware reqs 2013-07-04 15:43:17 +08:00
			`- Dual core CPU recommended`
add swap link 2014-03-02 06:53:30 +08:00			`- 2 GB RAM strongly recommended`
normalize on Docker installs 2014-02-25 17:11:32 +08:00
add swap link 2014-03-02 06:53:30 +08:00			`We also recommend you [enable swap][swap] for a total of 4 GB, so 2 GB swap with 2 GB RAM, and 3 GB swap with 1 GB ram, etc.`
add hardware reqs 2013-07-04 15:43:17 +08:00
update install doc 2013-07-31 05:42:07 +08:00			`### Software`
Initial release of Discourse 2013-02-06 03:16:51 +08:00
add swap link 2014-03-02 06:53:30 +08:00			`- [Postgres 9.1+](http://www.postgresql.org/download/)`
			`- [Redis 2.6+](http://redis.io/download)`
			`- [Ruby 1.9.3+](http://www.ruby-lang.org/en/downloads/) (we recommend 2.0.0-p353 or higher)`
added EMBED_CLOCKWORK so users can embed clockwork scheduling inside another process 2013-07-09 09:01:51 +08:00

normalize on Docker installs 2014-02-25 17:11:32 +08:00			`[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`
add swap link 2014-03-02 06:53:30 +08:00			`[swap]: https://www.digitalocean.com/community/articles/how-to-add-swap-on-ubuntu-12-04`