discourse/docs/INSTALL.md

40 lines
2.1 KiB
Markdown
Raw Normal View History

2013-07-30 17:48:40 -04:00
# How Do I Install Discourse?
2013-02-05 14:16:51 -05:00
2014-06-24 14:40:22 -04:00
Simple 30 minute basic install:
2014-02-25 04:11:32 -05:00
[**Beginner Docker install guide for Digital Ocean**][do]
2013-02-05 14:16:51 -05:00
2014-06-24 14:40:22 -04:00
Powerful, flexible, large or multiple server install:
2014-02-25 04:11:32 -05:00
[**Advanced Docker install guide**][docker]
2013-02-05 14:16:51 -05:00
2014-04-16 05:54:12 -04: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].)
2013-06-07 19:00:01 -04:00
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.
2014-04-16 05:50:04 -04:00
### Hardware Requirements
2013-07-04 03:43:17 -04:00
- Dual core CPU recommended
2014-04-16 05:50:04 -04:00
- 1 GB RAM minimum (with [swap][swap]), 2 GB recommended
2014-06-07 15:31:56 -04:00
- 64 bit Linux compatible with Docker
2013-07-04 03:43:17 -04:00
2014-04-16 05:50:04 -04:00
### Software Requirements
2013-02-05 14:16:51 -05:00
2014-03-01 17:53:30 -05: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)
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.
2014-02-25 04:11:32 -05: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
2014-03-01 17:53:30 -05:00
[swap]: https://www.digitalocean.com/community/articles/how-to-add-swap-on-ubuntu-12-04