discourse/docs/INSTALL.md

# How Do I Install Discourse?

Simple 30 minute basic install:
[**Beginner Docker install guide**][basic]

Powerful, flexible, large or multiple server install:
[**Advanced Docker install guide**][advanced]

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.

### 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.3+](http://www.postgresql.org/download/)
- [Redis 2.6+](http://redis.io/download)
- [Ruby 2.3+](http://www.ruby-lang.org/en/downloads/) (we recommend 2.3.1 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.

[basic]: https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md
[advanced]: https://github.com/discourse/discourse_docker
[swap]: https://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880
copyedits 2013-07-30 17:48:40 -04:00			`# How Do I Install Discourse?`
Initial release of Discourse 2013-02-05 14:16:51 -05:00
Minor note about docker. 2014-06-24 14:40:22 -04:00			`Simple 30 minute basic install:`
Update INSTALL.md 2015-01-30 19:39:44 -05:00			`[Beginner Docker install guide][basic]`
Initial release of Discourse 2013-02-05 14:16:51 -05:00
Minor note about docker. 2014-06-24 14:40:22 -04:00			`Powerful, flexible, large or multiple server install:`
Update INSTALL.md 2015-01-30 19:39:44 -05:00			`[Advanced Docker install guide][advanced]`
Initial release of Discourse 2013-02-05 14:16:51 -05:00
Update INSTALL.md 2015-01-30 19:34:09 -05: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.`
three main pre-reqs 2013-06-07 19:00:01 -04:00
Minor note about docker. 2014-06-24 14:40:22 -04: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 05:50:04 -04:00			`### Hardware Requirements`
add hardware reqs 2013-07-04 03:43:17 -04:00
			`- Dual core CPU recommended`
Update INSTALL.md just use 1GB as minimum RAM 2014-07-12 15:18:30 -04:00			`- 1 GB RAM minimum (with [swap][swap])`
Update INSTALL.md 2014-06-07 15:31:56 -04:00			`- 64 bit Linux compatible with Docker`
add hardware reqs 2013-07-04 03:43:17 -04:00
Update INSTALL.md 2014-04-16 05:50:04 -04:00			`### Software Requirements`
Initial release of Discourse 2013-02-05 14:16:51 -05:00
Bump recommended minimum PostgreSQL version to 9.3 2015-05-23 07:47:06 -04:00			`- [Postgres 9.3+](http://www.postgresql.org/download/)`
add swap link 2014-03-01 17:53:30 -05:00			`- [Redis 2.6+](http://redis.io/download)`
Update Ruby version in docs. 2016-08-24 03:48:15 -04:00			`- [Ruby 2.3+](http://www.ruby-lang.org/en/downloads/) (we recommend 2.3.1 or higher)`
added EMBED_CLOCKWORK so users can embed clockwork scheduling inside another process 2013-07-08 21:01:51 -04:00
move security link here 2014-04-25 22:46:22 -04: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.`

move "digital ocean" to "cloud" install 2015-03-30 18:20:51 -04:00			`[basic]: https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md`
Update INSTALL.md 2015-01-30 19:39:44 -05:00			`[advanced]: https://github.com/discourse/discourse_docker`
Update INSTALL.md link to our swap howto rather than generic 2014-07-12 15:17:38 -04:00			`[swap]: https://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880`