zulip/docs/production/docker.md
Alex Vandiver 39eb99def4 docs: Add Docker as a top-level entry in the production sidebar.
The official Docker image's documentation is published as a Read the
Docs subproject and is searchable from the parent project, but it
has no entry in the main docs sidebar — so a user navigating
zulip.readthedocs.io has no path to discover it short of a search
query.

Add a thin shim page in the production toctree, and redirect
existing in-prose `docker:index` references to it so the sidebar
entry becomes the canonical Docker navigation anchor.
2026-05-05 17:57:43 -07:00

1006 B

Running Zulip in Docker

Zulip provides an {doc}official Docker image <docker:index> for deployments that prefer to run services in containers. We recommend using it only if your organization has a preference for deploying this way; the Docker image moderately increases the effort required to install, maintain, and upgrade a Zulip installation, compared with the standard installer.

The Docker image supports two runtimes:

  • Docker Compose for single-host deployments. See the {doc}Docker Compose getting started guide <docker:how-to/compose-getting-started>.
  • Helm charts for Kubernetes deployments. See the {doc}Helm getting started guide <docker:how-to/helm-getting-started>.

Zulip's backup tool supports migrating between Docker and a standard installation, so you can change your mind later.

For configuration, secrets, networking, upgrades, and other operational topics, see the {doc}Docker documentation <docker:index> in full.