How to Install Zulip Server on Ubuntu 26.04 LTS
Install Zulip, the open-source team chat server, on Ubuntu 26.04 LTS with the official installer, HTTPS and outgoing email.
Zulip is an open-source team chat application that organises conversations into channels and topics. This guide installs a production Zulip server on Ubuntu 26.04 LTS with the project's own installer, a Let's Encrypt certificate and working outgoing email, and ends with your first organisation created. The steps are identical on Ubuntu 24.04 LTS, and the installer also supports Ubuntu 22.04 and Debian 12 and 13.
Ubuntu 16.04 left standard support in 2021 and current Zulip releases do not install on it. Older tutorials also assemble Zulip by hand with self-signed certificates and manual package installs; none of that is needed, because the installer sets up PostgreSQL, RabbitMQ, Redis, memcached, Nginx and the application itself. Zulip Server 13.2 was the current release when this was written.
Requirements
- A dedicated machine or VM with a fresh Ubuntu 26.04 installation on x86-64 or aarch64. The installer expects Zulip to be the only thing running on the system.
- Memory and CPU: at least 2 GB of RAM; with less than 5 GB, swap is required and 2 GB of swap is recommended. One CPU is enough for small teams; plan 2 CPUs and 4 GB of RAM for 100 or more users.
- Disk: 10 GB of free space, which means roughly a 25 GB disk in total.
- A host name such as
zulip.example.comwith a DNS record pointing at the server, needed for the TLS certificate. - SMTP credentials for an account Zulip can use to send email (invitations, confirmations, password resets).
- Network: incoming HTTPS on port 443, port 80 for the Let's Encrypt challenge, outgoing HTTP(S), and outgoing SMTP (usually port 587) to your mail provider.
Prepare the server
Update the system and reboot if a new kernel was installed:
sudo apt update
sudo apt -y full-upgradeIf the server has less than 5 GB of RAM and no swap (check with swapon --show), add a 2 GB swap file:
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstabIf you use UFW, allow SSH and the web ports before enabling it. Leave everything else closed; in particular port 4369, used by RabbitMQ's epmd, must not be reachable from the internet.
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enableDownload and run the installer
Download the latest release into a temporary directory and unpack it:
cd $(mktemp -d)
curl -fLO https://download.zulip.com/server/zulip-server-latest.tar.gz
tar -xf zulip-server-latest.tar.gzBecome root and start the installer. Replace the e-mail address with a real contact address for the people who maintain the server and the host name with the name users will type in their browser:
sudo -s
./zulip-server-*/scripts/setup/install --push-notifications --certbot \
--email=admin@example.com --hostname=zulip.example.comWhat the options do:
--certbotobtains a Let's Encrypt certificate for the host name and configures automatic renewal. For a test machine without public DNS, use--self-signed-certinstead; it is not suitable for production.--push-notificationsregisters the server with Zulip's Mobile Push Notification Service so the mobile apps can receive notifications; the installer asks you to agree to the service's terms. Use--no-push-notificationsto skip it.
The installation takes a few minutes. If it fails, fix the cause it reports and simply run the same command again; a transcript is kept in /var/log/zulip/install.log.
Create your organisation
At the end, the installer prints a one-time link for creating the first organisation. Open it in a browser and fill in the organisation name and your own account, which becomes the owner. If you lose the link or it has been used, generate a new one:
su zulip -c '/home/zulip/deployments/current/manage.py generate_realm_creation_link'Configure outgoing email
Zulip cannot invite users or reset passwords until it can send mail. Edit the main settings file:
nano /etc/zulip/settings.pyFind the SMTP section and set the values for your mail provider, for example:
EMAIL_HOST = "smtp.example.com"
EMAIL_HOST_USER = "zulip@example.com"
EMAIL_USE_TLS = True
EMAIL_PORT = 587The password does not go into that file. Add it to /etc/zulip/zulip-secrets.conf as a new line:
email_password = your-smtp-passwordRestart the server so the change takes effect, then send a test message:
su zulip -c '/home/zulip/deployments/current/scripts/restart-server'
su zulip -c '/home/zulip/deployments/current/manage.py send_test_email you@example.com'If the test fails, the attempt is logged in /var/log/zulip/send_email.log and the traceback in /var/log/zulip/errors.log.
Verify the installation
All Zulip processes run under Supervisor. As root, list them:
supervisorctl statusEvery entry, including zulip-django, zulip-tornado and the zulip-workers group, should show RUNNING with an uptime of more than a few seconds; a process that keeps restarting is crash-looping. Then open https://zulip.example.com, log in and send a message.
Maintenance and troubleshooting
- Logs are in
/var/log/zulip/. Start witherrors.log;server.logholds the Django and Tornado logs andworkers.logthe queue workers. - Settings changes in
/etc/zulip/settings.pyalways needrestart-serveras shown above; restarting a single process withsupervisorctlis not enough. - Backups: as the
zulipuser,/home/zulip/deployments/current/manage.py backup --output=/home/zulip/zulip-backup.tar.gzwrites a full backup archive. Copy it off the server. - Upgrades: download the new release and run the upgrade script as root.
curl -fLO https://download.zulip.com/server/zulip-server-latest.tar.gz
/home/zulip/deployments/current/scripts/upgrade-zulip zulip-server-latest.tar.gzUpgrading the operating system to a new Ubuntu release needs extra steps on the Zulip side; follow the upgrade chapter of the Zulip production documentation rather than a plain do-release-upgrade.
Frequently asked questions
Can I install Zulip on a server that already runs other websites?
The standard installer is designed for a dedicated machine and takes over Nginx, PostgreSQL and other services. If you must share a host, use the project's Docker image or put Zulip in its own VM; the documentation describes advanced deployment options such as running behind a reverse proxy.
Do I have to enable the push notification service?
No. Without it the web and desktop apps work normally, but the mobile apps do not receive push notifications from a self-hosted server. You can install with --no-push-notifications and register later.
Can I import data from Slack or Mattermost?
Yes, Zulip has import tools for Slack, Mattermost, Rocket.Chat and Zulip Cloud exports. Run the installer, but do not create an organisation with the link it prints; continue with the import instructions for your source instead.
How much server do I need for a small team?
For installations with fewer than 100 users, the documentation considers 1 CPU and 2 GB of RAM with 2 GB of swap sufficient. Disk use grows mainly with uploaded files.