2016-08-09 22:21:19 +02:00
|
|
|
# Requirements
|
2016-07-12 21:35:25 +02:00
|
|
|
|
2016-07-28 01:38:02 +02:00
|
|
|
Note that if you just want to play around with Zulip and see what it looks
|
|
|
|
like, it is easier to install it in a development environment
|
|
|
|
following [these
|
|
|
|
instructions](readme-symlink.html#installing-the-zulip-development-environment),
|
|
|
|
since then you don't need to worry about setting up SSL certificates and an
|
|
|
|
authentication mechanism. Or, you can check out the
|
2016-10-26 10:12:32 +02:00
|
|
|
[developers' chatroom](http://chat.zulip.org/) (a public, running Zulip
|
2016-07-28 01:38:02 +02:00
|
|
|
instance).
|
|
|
|
|
2016-08-25 00:19:10 +02:00
|
|
|
## Server
|
2016-07-28 01:38:02 +02:00
|
|
|
|
2016-08-25 00:19:10 +02:00
|
|
|
#### Hardware Specifications
|
2016-07-28 01:38:02 +02:00
|
|
|
|
2016-11-27 04:04:35 +01:00
|
|
|
* CPU and Memory: For installations with 100+ users you'll need a
|
|
|
|
minimum of **2 CPUs** and **4GB RAM**. For installations with fewer
|
|
|
|
users, 1 CPU and 2GB RAM is sufficient. We strong recommend against
|
|
|
|
installing with less than 2GB of RAM, as you will likely experience
|
|
|
|
out of memory issues installing dependencies. We recommend against
|
|
|
|
using highly CPU-limited servers like the AWS `t2` style instances
|
|
|
|
for organizations with a hundreds of users (active or no).
|
2016-07-28 01:38:02 +02:00
|
|
|
|
|
|
|
* Disk space: You'll need at least 10GB of free disk space. If you intend to
|
|
|
|
store uploaded files locally rather than on S3 you will likely need more.
|
|
|
|
|
2016-08-25 00:19:10 +02:00
|
|
|
#### Network and Security Specifications
|
2016-07-28 01:38:02 +02:00
|
|
|
|
|
|
|
* Outgoing HTTP(S) access to the public Internet. If you want to be able to
|
|
|
|
send email from Zulip, you'll also need SMTP access.
|
|
|
|
|
2016-08-25 00:19:10 +02:00
|
|
|
#### Operating System
|
|
|
|
|
2016-08-25 06:44:08 +02:00
|
|
|
Ubuntu 14.04 Trusty and Ubuntu 16.04 Xenial are supported for running
|
|
|
|
Zulip in production. 64-bit is recommended.
|
2016-08-25 00:19:10 +02:00
|
|
|
|
|
|
|
#### Domain name
|
|
|
|
|
|
|
|
You should already have a domain name available for your Zulip
|
|
|
|
production instance. In order to generate valid SSL certificates with Let's
|
|
|
|
Encrypt, and to enable other services such as Google Authentication, you'll
|
|
|
|
need to update the domains A record to point to your production server.
|
|
|
|
|
|
|
|
## Credentials needed
|
|
|
|
|
|
|
|
#### SSL Certificate
|
|
|
|
|
2016-07-28 01:38:02 +02:00
|
|
|
* SSL Certificate for the host you're putting this on (e.g. zulip.example.com).
|
|
|
|
The installation instructions contain documentation for how to get an SSL
|
|
|
|
certificate for free using [LetsEncrypt](https://letsencrypt.org/).
|
|
|
|
|
2016-08-25 00:19:10 +02:00
|
|
|
#### Outgoing email
|
2016-07-28 01:38:02 +02:00
|
|
|
|
2016-07-12 21:35:25 +02:00
|
|
|
* Email credentials Zulip can use to send outgoing emails to users
|
|
|
|
(e.g. email address confirmation emails during the signup process,
|
|
|
|
missed message notifications, password reminders if you're not using
|
|
|
|
SSO, etc.).
|
|
|
|
|
2016-07-28 01:38:02 +02:00
|
|
|
Once you have met these requirements, see [full instructions for installing
|
|
|
|
Zulip in production](prod-install.html).
|