discourse/docs/INSTALL.md

# How Do I Install Discourse?

Simple 30 minute basic install:
[**Beginner Docker install guide for Digital Ocean**][do]

Powerful, flexible, large or multiple server 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. We regret that we cannot 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].)

### Why do you only officially support Docker?

Hosting Rails applications is complicated. Even if you already have Postgres, Redis and Ruby installed on your server, you still need to worry about running and monitoring your Sidekiq and Rails processes. Additionally, our Docker install comes bundled with a web-based GUI that makes upgrading to new versions of Discourse as easy as clicking a button.

### Hardware Requirements

- Dual core CPU recommended
- 1 GB RAM minimum (with [swap][swap])
- 64 bit Linux compatible with Docker

### Software Requirements

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


## Security

We take security very seriously at Discourse, and all our code is 100% open source and peer reviewed. Please read [our security guide](https://github.com/discourse/discourse/blob/master/docs/SECURITY.md) for an overview of security measures in Discourse.

[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://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880
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
Minor note about docker. 2014-06-25 02:40:22 +08:00			`Simple 30 minute basic install:`
normalize on Docker installs 2014-02-25 17:11:32 +08:00			`[Beginner Docker install guide for Digital Ocean][do]`
Initial release of Discourse 2013-02-06 03:16:51 +08:00
Minor note about docker. 2014-06-25 02:40:22 +08:00			`Powerful, flexible, large or multiple server install:`
normalize on Docker installs 2014-02-25 17:11:32 +08:00			`[Advanced Docker install guide][docker]`
Initial release of Discourse 2013-02-06 03:16:51 +08:00
Update INSTALL.md 2014-04-16 17:54:12 +08:00			`The only officially supported installs of Discourse are the [Docker](https://www.docker.io/) based beginner and advanced installs. We regret that we cannot 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].)`
three main pre-reqs 2013-06-08 07:00:01 +08:00
Minor note about docker. 2014-06-25 02:40:22 +08:00			`### Why do you only officially support Docker?`

			`Hosting Rails applications is complicated. Even if you already have Postgres, Redis and Ruby installed on your server, you still need to worry about running and monitoring your Sidekiq and Rails processes. Additionally, our Docker install comes bundled with a web-based GUI that makes upgrading to new versions of Discourse as easy as clicking a button.`

Update INSTALL.md 2014-04-16 17:50:04 +08:00			`### Hardware Requirements`
add hardware reqs 2013-07-04 15:43:17 +08:00
			`- Dual core CPU recommended`
Update INSTALL.md just use 1GB as minimum RAM 2014-07-13 03:18:30 +08:00			`- 1 GB RAM minimum (with [swap][swap])`
Update INSTALL.md 2014-06-08 03:31:56 +08:00			`- 64 bit Linux compatible with Docker`
add hardware reqs 2013-07-04 15:43:17 +08:00
Update INSTALL.md 2014-04-16 17:50:04 +08:00			`### Software Requirements`
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)`
remove 1.9.3 from docs 2014-10-03 09:08:43 +08:00			`- [Ruby 2.0+](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

move security link here 2014-04-26 10:46:22 +08:00
			`## Security`

			`We take security very seriously at Discourse, and all our code is 100% open source and peer reviewed. Please read [our security guide](https://github.com/discourse/discourse/blob/master/docs/SECURITY.md) for an overview of security measures in Discourse.`

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`
Update INSTALL.md link to our swap howto rather than generic 2014-07-13 03:17:38 +08:00			`[swap]: https://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880`