Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
zulip/docs/production/requirements.md

99 lines
4.2 KiB
Markdown
Raw Normal View History

docs: Improve Zulip in Production page navigation and ToC. Improves readability of ToC and makes pages more navigable by shortening Zulip in Production page headings.
2016-08-09 22:21:19 +02:00
# Requirements
Move production installation requirements to separate page. To begin the process of consolidating Zulip documentation on Read the Docs, the requirements are now their own topic page, and index.rst links to it. Fixes: #669.
2016-07-12 21:35:25 +02:00
docs: Stop recommending the dev environment in prod.md. The dev environment has none of the onboarding that chat.zulip.org and the prod install have.
2017-11-13 23:27:36 +01:00
Note that if you just want to play around with Zulip and see what it looks
like, we recommend creating an account on the
docs: Fix some Markdown links missing a close-paren. These were just introduced today.
2017-11-16 20:39:29 +01:00
[Zulip community server](../contributing/chat-zulip-org.html), or creating a test
docs: Stop recommending the dev environment in prod.md. The dev environment has none of the onboarding that chat.zulip.org and the prod install have.
2017-11-13 23:27:36 +01:00
organization on <https://zulipchat.com>.
docs: Improve production requirements doc. - Adds headings and organizes for greater clarity. - Adds some detail about each of the requirements.
2016-07-28 01:38:02 +02:00
docs: Reorganize requirements page with server/credentials categories.
2016-08-25 00:19:10 +02:00
## Server
docs: Improve production requirements doc. - Adds headings and organizes for greater clarity. - Adds some detail about each of the requirements.
2016-07-28 01:38:02 +02:00
install docs: Say explicitly that Zulip should have its own (virtual) machine. This is the main thing that https://zulip.org/server.html explains that we don't yet in our main documentation tree.
2017-07-26 00:32:51 +02:00
#### General
docs: Add tips on installing on an existing server.
2017-05-24 22:36:15 +02:00
The installer expects Zulip to be the **only thing** running on the
install docs: Say explicitly that Zulip should have its own (virtual) machine. This is the main thing that https://zulip.org/server.html explains that we don't yet in our main documentation tree.
2017-07-26 00:32:51 +02:00
system; it will install system packages with `apt` (like nginx,
postgresql, and redis) and configure them for its own use. We
docs: Add tips on installing on an existing server.
2017-05-24 22:36:15 +02:00
strongly recommend using either a fresh machine instance in a cloud
provider, a fresh VM, or a dedicated machine. If you decide to
disregard our advice and use a server that hosts other services, we
can't support you, but
docs: Reorganize developer docs to improve navigation. This commit helps reduce clutter on the navigation sidebar. Creates new directories and moves relevant files into them. Modifies index.rst, symlinks, and image paths accordingly. This commit also enables expandable/collapsible navigation items, renames files in docs/development and docs/production, modifies /tools/test-documentation so that it overrides a theme setting, Also updates links to other docs, file paths in the codebase that point to developer documents, and files that should be excluded from lint tests. Note that this commit does not update direct links to zulip.readthedocs.io in the codebase; those will be resolved in an upcoming follow-up commit (it'll be easier to verify all the links once this is merged and ReadTheDocs is updated). Fixes #5265.
2017-11-08 17:55:36 +01:00
[we do have some notes on issues you'll encounter](install-existing-server.html).
install docs: Say explicitly that Zulip should have its own (virtual) machine. This is the main thing that https://zulip.org/server.html explains that we don't yet in our main documentation tree.
2017-07-26 00:32:51 +02:00
#### Operating System
docs: Recommend Xenial over Trusty for new installations.
2017-10-20 23:33:50 +02:00
Ubuntu 16.04 Xenial and Ubuntu 14.04 Trusty are supported for running
Zulip in production. 64-bit is recommended. We recommend Xenial if
you have a choice, since 14.04 is approaching end-of-life and you'll
save yourself the work of upgrading in a few months.
install docs: Say explicitly that Zulip should have its own (virtual) machine. This is the main thing that https://zulip.org/server.html explains that we don't yet in our main documentation tree.
2017-07-26 00:32:51 +02:00
docs: Reorganize requirements page with server/credentials categories.
2016-08-25 00:19:10 +02:00
#### Hardware Specifications
docs: Improve production requirements doc. - Adds headings and organizes for greater clarity. - Adds some detail about each of the requirements.
2016-07-28 01:38:02 +02:00
requirements: Document anti-recommendation of t2 style instances. If your instance runs out of CPU credits, it will result in a nasty outage. Fixes #1605.
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
prod-requirements.md: Fix grammar. Change "strong" to "strongly" (adverb).
2017-04-12 05:48:02 +02:00
users, 1 CPU and 2GB RAM is sufficient. We strongly recommend against
requirements: Document anti-recommendation of t2 style instances. If your instance runs out of CPU credits, it will result in a nasty outage. Fixes #1605.
2016-11-27 04:04:35 +01:00
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).
docs: Improve production requirements doc. - Adds headings and organizes for greater clarity. - Adds some detail about each of the requirements.
2016-07-28 01:38:02 +02:00
docs: Improve documentation on resource requirements.
2017-06-04 08:38:44 +02:00
See our
docs: Reorganize developer docs to improve navigation. This commit helps reduce clutter on the navigation sidebar. Creates new directories and moves relevant files into them. Modifies index.rst, symlinks, and image paths accordingly. This commit also enables expandable/collapsible navigation items, renames files in docs/development and docs/production, modifies /tools/test-documentation so that it overrides a theme setting, Also updates links to other docs, file paths in the codebase that point to developer documents, and files that should be excluded from lint tests. Note that this commit does not update direct links to zulip.readthedocs.io in the codebase; those will be resolved in an upcoming follow-up commit (it'll be easier to verify all the links once this is merged and ReadTheDocs is updated). Fixes #5265.
2017-11-08 17:55:36 +01:00
[documentation on scalability](../production/maintain-secure-upgrade.html#scalability)
docs: Improve documentation on resource requirements.
2017-06-04 08:38:44 +02:00
for advice on hardware requirements for larger organizations.
docs: Update recommendations of disk requirements. Addresses part of #5724.
2017-07-07 21:40:00 +02:00
* Disk space: You'll need at least 10GB of free disk space for a
server with dozens of users. If you intend to store uploaded files
locally rather than on S3 you will likely need more, depending how
often your users upload large files. You'll eventually need 100GB
or more if you have thousands of active users or millions of total
messages sent.
docs: Improve production requirements doc. - Adds headings and organizes for greater clarity. - Adds some detail about each of the requirements.
2016-07-28 01:38:02 +02:00
docs: Reorganize requirements page with server/credentials categories.
2016-08-25 00:19:10 +02:00
#### Network and Security Specifications
docs: Improve production requirements doc. - Adds headings and organizes for greater clarity. - Adds some detail about each of the requirements.
2016-07-28 01:38:02 +02:00
requirements: Document more clearly ports required for Zulip.
2017-01-10 20:40:47 +01:00
* Incoming HTTPS access (usually port 443, though this is
configurable) from the networks where your users are (usually, the
public Internet). If you also open port 80, Zulip will redirect
users to HTTPS rather than not working when users type
e.g. `http://zulip.example.com` in their browser. If you are using
Zulip's [incoming email integration][email-mirror-code] you may also
need incoming port 25 open.
[email-mirror-code]: https://github.com/zulip/zulip/blob/master/zerver/management/commands/email_mirror.py
* Outgoing HTTP(S) access (ports 80 and 443) to the public Internet so
docs: Update email configuration documentation. Fixes #2958.
2017-02-22 06:12:12 +01:00
that Zulip can properly manage inline image previews. You'll also
need outgoing SMTP access to your SMTP server (the standard port for
this is 587) so that Zulip can send email.
docs: Improve production requirements doc. - Adds headings and organizes for greater clarity. - Adds some detail about each of the requirements.
2016-07-28 01:38:02 +02:00
docs: Reorganize requirements page with server/credentials categories.
2016-08-25 00:19:10 +02:00
#### Domain name
docs: Tweak discussion of SSL certs in prod requirements.
2017-12-13 05:08:35 +01:00
You should already have a domain name (e.g., `zulip.example.com`)
available for your Zulip server. In order to generate valid SSL
certificates [with Certbot][doc-certbot], and to enable other services
such as Google authentication, you'll need to set the domain's
A record to point to your production server.
docs: Reorganize requirements page with server/credentials categories.
2016-08-25 00:19:10 +02:00
## Credentials needed
#### SSL Certificate
docs: Tweak discussion of SSL certs in prod requirements.
2017-12-13 05:08:35 +01:00
* Your Zulip server will need an SSL certificate for the domain name
it uses. For most Zulip servers, the recommended (and simplest) way
to get this is to just [use the `--certbot` option][doc-certbot] in
the Zulip installer, which will automatically get a certificate for
you and keep it renewed. If you'd rather acquire an SSL certificate
another way, see our
docs: Update documentation to recommend certbot.
2017-10-28 02:46:31 +02:00
[SSL certificate documentation](ssl-certificates.html).
docs: Improve production requirements doc. - Adds headings and organizes for greater clarity. - Adds some detail about each of the requirements.
2016-07-28 01:38:02 +02:00
docs: Tweak discussion of SSL certs in prod requirements.
2017-12-13 05:08:35 +01:00
[doc-certbot]: ../production/ssl-certificates.html#certbot-recommended
docs: Reorganize requirements page with server/credentials categories.
2016-08-25 00:19:10 +02:00
#### Outgoing email
docs: Improve production requirements doc. - Adds headings and organizes for greater clarity. - Adds some detail about each of the requirements.
2016-07-28 01:38:02 +02:00
docs: Update email configuration documentation. Fixes #2958.
2017-02-22 06:12:12 +01:00
* Outgoing email (SMTP) credentials that Zulip can use to send
outgoing emails to users (e.g. email address confirmation emails
during the signup process, missed message notifications, password
reset, etc.). If you don't have an existing outgoing SMTP solution,
read about
docs: Reorganize developer docs to improve navigation. This commit helps reduce clutter on the navigation sidebar. Creates new directories and moves relevant files into them. Modifies index.rst, symlinks, and image paths accordingly. This commit also enables expandable/collapsible navigation items, renames files in docs/development and docs/production, modifies /tools/test-documentation so that it overrides a theme setting, Also updates links to other docs, file paths in the codebase that point to developer documents, and files that should be excluded from lint tests. Note that this commit does not update direct links to zulip.readthedocs.io in the codebase; those will be resolved in an upcoming follow-up commit (it'll be easier to verify all the links once this is merged and ReadTheDocs is updated). Fixes #5265.
2017-11-08 17:55:36 +01:00
[free outgoing SMTP options and options for prototyping](email.html#free-outgoing-email-services).
Move production installation requirements to separate page. To begin the process of consolidating Zulip documentation on Read the Docs, the requirements are now their own topic page, and index.rst links to it. Fixes: #669.
2016-07-12 21:35:25 +02:00
docs: Improve production requirements doc. - Adds headings and organizes for greater clarity. - Adds some detail about each of the requirements.
2016-07-28 01:38:02 +02:00
Once you have met these requirements, see [full instructions for installing
docs: Reorganize developer docs to improve navigation. This commit helps reduce clutter on the navigation sidebar. Creates new directories and moves relevant files into them. Modifies index.rst, symlinks, and image paths accordingly. This commit also enables expandable/collapsible navigation items, renames files in docs/development and docs/production, modifies /tools/test-documentation so that it overrides a theme setting, Also updates links to other docs, file paths in the codebase that point to developer documents, and files that should be excluded from lint tests. Note that this commit does not update direct links to zulip.readthedocs.io in the codebase; those will be resolved in an upcoming follow-up commit (it'll be easier to verify all the links once this is merged and ReadTheDocs is updated). Fixes #5265.
2017-11-08 17:55:36 +01:00
Zulip in production](../production/install.html).