discourse/docs/INSTALL.md

35 lines
1.8 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
2016-12-31 04:08:18 -05:00
> :bell: The only officially supported installs of Discourse are [Docker](https://www.docker.io/) based. You must have SSH access to a 64-bit Linux server **with Docker support**. We regret that we cannot support any other methods of installation including cpanel, plesk, webmin, etc.
2016-12-31 04:04:27 -05:00
2016-12-31 04:05:46 -05:00
Simple 30 minute basic install:
2015-01-30 19:39:44 -05:00
[**Beginner Docker install guide**][basic]
2013-02-05 14:16:51 -05:00
2016-12-31 04:05:46 -05:00
Powerful, flexible, large / multiple server install:
2015-01-30 19:39:44 -05:00
[**Advanced Docker install guide**][advanced]
2013-02-05 14:16:51 -05:00
2014-06-24 14:40:22 -04:00
### Why do you only officially support Docker?
2016-12-31 04:04:27 -05:00
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, as well as configuring Nginx. With Docker, our fully optimized Discourse configuration is available to you in a simple container, along with a web-based GUI that makes upgrading to new versions of Discourse as easy as clicking a button.
2014-06-24 14:40:22 -04:00
2014-04-16 05:50:04 -04:00
### Hardware Requirements
2013-07-04 03:43:17 -04:00
- modern single core CPU, dual core recommended
- 1 GB RAM minimum (with [swap][swap])
2014-06-07 15:31:56 -04:00
- 64 bit Linux compatible with Docker
- 10 GB disk space minimum
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
- [Postgres 9.5+](http://www.postgresql.org/download/)
2014-03-01 17:53:30 -05:00
- [Redis 2.6+](http://redis.io/download)
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)
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.
[basic]: https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md
2015-01-30 19:39:44 -05:00
[advanced]: https://github.com/discourse/discourse_docker
[swap]: https://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880