https://github.com/zulip/docker-zulip
Container configurations, images, and examples for Zulip.
https://github.com/zulip/docker-zulip
docker helm kubernetes zulip
Last synced: 2 months ago
JSON representation
Container configurations, images, and examples for Zulip.
- Host: GitHub
- URL: https://github.com/zulip/docker-zulip
- Owner: zulip
- License: apache-2.0
- Created: 2015-09-26T12:28:02.000Z (over 10 years ago)
- Default Branch: main
- Last Pushed: 2025-04-16T07:52:05.000Z (about 1 year ago)
- Last Synced: 2025-05-13T16:09:59.536Z (11 months ago)
- Topics: docker, helm, kubernetes, zulip
- Language: Shell
- Homepage: https://zulip.com/
- Size: 1.08 MB
- Stars: 617
- Watchers: 23
- Forks: 271
- Open Issues: 64
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Zulip Docker image overview
[](https://chat.zulip.org/#narrow/channel/31-production-help/topic/docker)
This is the official Docker container image for running a [Zulip
server](https://zulip.com) in production. Built images are
available from [ghcr.io](https://ghcr.io/zulip/zulip-server):
```console
$ docker pull ghcr.io/zulip/zulip-server:11.5-0
```
Current Zulip version: `11.5`
Current Docker image version: `11.5-0`
> [!NOTE]
> A previous packaging of Zulip for Docker still exists on Docker Hub, as
> [zulip/docker-zulip](https://hub.docker.com/r/zulip/docker-zulip). That version
> will continue to be supported through the end of the Zulip Server 11.x series.
> See the [upgrade steps][upgrade].
We recommend using the Docker image if your organization has a
preference for deploying services using Docker. Deploying with Docker
moderately increases the effort required to install, maintain, and
upgrade a Zulip installation, compared with the [standard Zulip
installer][normal-install].
[upgrade]: https://zulip.readthedocs.io/projects/docker/en/latest/how-to/compose-upgrading.html#upgrading-from-zulip-docker-zulip-11-x-and-earlier
[normal-install]: https://zulip.readthedocs.io/en/latest/production/install.html
[zulip-architecture]: https://zulip.readthedocs.io/en/latest/overview/architecture-overview.html
## Prerequisites
To use this image, you need the following:
- An installation of [Docker][install-docker] and [Docker
Compose][install-docker-compose], or a [Kubernetes][k8s] runtime engine.
- We [recommend at least 2GB of available RAM][prod-requirements] for running a
production Zulip server; you'll want 4GB if you're building the container
(rather than using the pre-built images). If you're just testing and/or aren't
expecting a lot of users/messages, you can get away with significantly less
especially for the `postgres`, `memcached`, etc. containers, because Docker
makes it easy to sharply limit the RAM allocated to the services Zulip depends
on, like Redis, memcached, and PostgreSQL (at the cost of potential
performance issues).
This project doesn't support `docker-rootless` or `uDocker`; Zulip needs root
access to set properties like the maximum number of open file descriptions via
`ulimit` (which is important for it to handle thousands of connected clients).
[install-docker]: https://docs.docker.com/install/
[install-docker-compose]: https://docs.docker.com/compose/install/
[k8s]: https://kubernetes.io/
[prod-requirements]: https://zulip.readthedocs.io/en/latest/production/requirements.html
## Documentation
See our [main documentation][docker-zulip-docs].
[docker-zulip-docs]: https://zulip.readthedocs.io/projects/docker/