Run your own Zulip server

To set up Zulip for your team, you will need to install an instance of the Zulip server.

Requirements

Zulip supports installation on Ubuntu 14.04 Trusty and Ubuntu 16.04 Xenial. If you'd like to install Zulip on a different system, contact the Zulip development discussion mailing list for help.

WARNING: This automated installation process expects to be the only thing running on a server (it uses Puppet, etc.). It's likely additional installation options will be implemented by the community over the coming weeks (both in terms of distros and methods). If you'd like to hear about these sorts of things as they become available, sign up for the Zulip announcement list. Finally, note that the developers' chatroom (a running Zulip instance) or the Zulip development environment may be a better choice if you just want to play around with Zulip and aren't ready to commit to setting up a production server with SSL certificates, secure authentication, etc.

You can run a Zulip server for a small site on a system with 2G of RAM, but for production use with more than a few dozen users, we recommend a system with 4GB of RAM or more. (Decreasing this should be very doable and is being tracked on GitHub).

You will also need to have an SSL certificate available and email credentials needed to send outgoing email (the installation docs have instructions for how to get a free SSL certificate from LetsEncrypt).

Installation

Download the tarball

Instructions for downloading the binary tarball, verifying its sha1sum matches, extracting it, and moving the resulting directory to /root/zulip (where it's expected to live):

cd /root
wget https://www.zulip.org/dist/releases/zulip-server-1.5.1.tar.gz
echo "c73e617c5b9fab7a201db55345171b1c8c73cc20 zulip-server-1.5.1.tar.gz" | sha1sum -c
tar -xf zulip-server-1.5.1.tar.gz
mv zulip-server-1.5.1 zulip

Follow installation guide

Consult the Zulip in production documentation for installation instructions and tips to troubleshoot common issues.

Announcement mailing list

We highly recommend signing up for the Zulip announcement mailing list so you will hear about new Zulip server releases (including any security announcements), new releases of the desktop and mobile apps, etc.

If you run into any trouble setting up your Zulip installation and can't find a solution in our documentation, feel free to contact zulip-help@googlegroups.com for troubleshooting help.

Integrations

Once you have the Zulip server running, you can reconfigure various options, auth methods, and built-in integrations in /etc/zulip/settings.py. In order for these changes to take effect, you will need to restart the server using:

su zulip -c /home/zulip/deployments/current/scripts/restart-server