Dockerfile: Push images to ghcr.io/zulip/zulip-server.

This separates it from the zulip/docker-zulip image on Docker Hub,
which will continue to get backwards-compatible updates through 11.x.

Author: alexmv

.github/workflows/cleanup.yaml

@@ -1,4 +1,4 @@
-name: Daily GHCR untaged docker-zulip cleanup
+name: Daily GHCR untagged docker-zulip cleanup
 
 on:
   schedule:
@@ -17,6 +17,6 @@ jobs:
         with:
           delete-only-untagged-versions: "true"
           min-versions-to-keep: 10
-          package-name: "docker-zulip"
+          package-name: "zulip-server"
           package-type: "container"
           token: ${{ github.token }}

.github/workflows/dockerfile-build.yaml

@@ -1,5 +1,5 @@
 ---
-name: Build and push images to ghcr.io/zulip/docker-zulip
+name: Build and push images to ghcr.io/zulip/zulip-server
 
 on:
   push:
@@ -11,6 +11,9 @@ on:
 
 permissions: {}
 
+env:
+  PACKAGE_NAME: ghcr.io/zulip/zulip-server
+
 jobs:
   build:
     strategy:
@@ -40,7 +43,7 @@ jobs:
         id: meta
         uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5
         with:
-          images: ghcr.io/${{ github.repository }}
+          images: ${PACKAGE_NAME}
           tags: |
             type=ref,event=branch
             type=match,pattern=\d+\.\d+-\d+
@@ -76,7 +79,7 @@ jobs:
           context: .
           platforms: ${{ matrix.platform }}
           pull: true
-          tags: ghcr.io/${{ github.repository }}
+          tags: ${PACKAGE_NAME}
           labels: ${{ steps.meta.outputs.labels }}
           annotations: ${{ steps.meta.outputs.annotations }}
           build-args: |
@@ -119,7 +122,7 @@ jobs:
         id: meta
         uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5
         with:
-          images: ghcr.io/${{ github.repository }}
+          images: ${PACKAGE_NAME}
           labels: |
             org.opencontainers.image.description=Zulip Server
           annotations: |
@@ -147,10 +150,10 @@ jobs:
           docker buildx imagetools create \
             $(for tag in "${TAGS_LIST[@]}"; do echo "--tag"; echo "$tag"; done) \
             $(for annotation in "${ANNOTATIONS_LIST[@]}"; do echo "--annotation"; echo "$annotation"; done) \
-            $(for reference in *; do printf "ghcr.io/${{ github.repository }}@sha256:%s\n" $reference; done)
+            $(for reference in *; do printf "${PACKAGE_NAME}@sha256:%s\n" $reference; done)
 
       - name: Inspect image
         run: |
-          docker buildx imagetools inspect ghcr.io/${{ github.repository }}:${STEPS_META_OUTPUTS_VERSION}
+          docker buildx imagetools inspect ${PACKAGE_NAME}:${STEPS_META_OUTPUTS_VERSION}
         env:
           STEPS_META_OUTPUTS_VERSION: ${{ steps.meta.outputs.version }}

.github/workflows/dockerfile.yaml

@@ -44,7 +44,7 @@ jobs:
         uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83 # v6
         with:
           context: .
-          tags: zulip/docker-zulip:pr-${{ github.event.pull_request.number }}
+          tags: zulip/zulip-server:pr-${{ github.event.pull_request.number }}
           outputs: type=docker,dest=/tmp/image.tar
           build-args: |
             ZULIP_GIT_REF=${{ steps.get-sha.outputs.commit_sha }}
@@ -150,7 +150,7 @@ jobs:
       - name: Load image into kind
         run: |
           docker load --input /tmp/image.tar
-          kind load docker-image zulip/docker-zulip:pr-${{ github.event.pull_request.number }} --name chart-testing
+          kind load docker-image zulip/zulip-server:pr-${{ github.event.pull_request.number }} --name chart-testing
 
       - name: Run chart-testing (install)
         id: chart-testing-install
@@ -194,7 +194,7 @@ jobs:
       - build
       - docker-compose-collect
     env:
-      GITHUB_CI_IMAGE: ${{ github.repository }}:pr-${{ github.event.pull_request.number }}
+      GITHUB_CI_IMAGE: zulip/zulip-server:pr-${{ github.event.pull_request.number }}
     strategy:
       fail-fast: false
       matrix:

README.md

@@ -2,18 +2,22 @@
 
 [![**docker** topic in **production-help** channel](https://img.shields.io/badge/zulip-join_chat-brightgreen.svg)](https://chat.zulip.org/#narrow/channel/31-production-help/topic/docker)
 
-`docker-zulip` is the official Docker container image for running a
-[Zulip server](https://zulip.com) in
-[production][prod-overview]. Built images are available from: [Docker
-Hub](https://hub.docker.com/r/zulip/docker-zulip):
+This is the official Docker container image for running a [Zulip
+server](https://zulip.com) in [production][prod-overview]. Built images are
+available from [ghcr](https://ghcr.io/zulip/zulip-server/)
 
 ```console
-$ docker pull zulip/docker-zulip:11.5-0
+$ 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](hub.docker.com/r/zulip/docker-zulip). That version will
+> continue to be supported through the end of the Zulip Server 11.x series.
+
 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
@@ -25,7 +29,7 @@ installer][normal-install].
 
 ## Prerequisites
 
-To use `docker-zulip`, you need the following:
+To use this image, you need the following:
 
 - An installation of [Docker][install-docker] and
   [Docker Compose][install-docker-compose] or a Kubernetes runtime
@@ -436,10 +440,9 @@ PRs. Some particularly useful ways to contribute right now are:
 
 ## Credits
 
-Huge thanks to everyone who has contributed. Special thanks to
-[Alexander Trost](http://github.com/galexrt/), who created
-`docker-zulip` and did a huge amount of the early work required to
-make a high-quality Docker image for Zulip possible.
+Huge thanks to everyone who has contributed. Special thanks to [Alexander
+Trost](http://github.com/galexrt/), who created the first Docker packaging of
+Zulip Server.
 
 [install-normal]: https://zulip.readthedocs.io/en/latest/production/install.html#installer-options
 [outgoing-email]: https://zulip.readthedocs.io/en/latest/production/email.html

UPGRADING.md

@@ -24,20 +24,19 @@ All of the instructions below assume you are using the provided
    Note that `docker-zulip` did not support for Zulip's built-in
    `restore-backup` tool before Zulip 3.0.
 
-1. Pull the new image version, e.g. for `2.0.8` run:
+1. Pull the new image version, e.g. for `11.5` run:
 
    ```shell
-   docker pull zulip/docker-zulip:2.0.8-0
+   docker pull ghcr.io/zulip/zulip-server:11.5-0
    ```
 
    We recommend always upgrading to the latest minor release within a major
    release series.
 
-2. Update this project to the corresponding `docker-zulip` version and resolve
+2. Update this project to the corresponding image version and resolve
    any merge conflicts in `docker-compose.yml`. This is important as new Zulip
    releases may require additional settings to be specified in
-   `docker-compose.yml` (E.g. authentication settings for `memcached` became
-   mandatory in the `2.1.2` release).
+   `docker-compose.yml`
 
    **Note:** Do not make any changes to the database version or volume. If there
    is a difference in database version, leave those unchanged for now, and
@@ -51,7 +50,7 @@ All of the instructions below assume you are using the provided
 
    ```yaml
    zulip:
-     image: "zulip/docker-zulip:2.0.1-0"
+     image: "ghcr.io/zulip/zulip-server:11.5-0"
    ```
 
 4. You can execute the upgrade by running:
@@ -79,7 +78,7 @@ docker compose exec -u zulip zulip cat /home/zulip/deployments/current/version.p
 
    ```yaml
    zulip:
-     # image: "zulip/docker-zulip:2.0.1-0"
+     # image: "ghcr.io:zulip/zulip-server:11.5-0"
      build:
        context: .
        args:
@@ -90,7 +89,7 @@ docker compose exec -u zulip zulip cat /home/zulip/deployments/current/version.p
 
    You can set `ZULIP_GIT_URL` to any clone of the zulip/zulip git repository,
    and `ZULIP_GIT_REF` to be any ref name in that repository (e.g. `main` or
-   `1.9.0` or `445932cc8613c77ced023125248c8b966b3b7528`).
+   `11.5` or `3ca9cefbb3a380c9563eb665940952e572a1fb60`).
 
 2. Run `docker compose build zulip` to build a Zulip Docker image from the
    specified Git version.
@@ -99,7 +98,7 @@ Then stop and restart the container as described in the previous section.
 
 ## Upgrading to use Docker volumes (version 6.0-0 and above)
 
-As of Docker Zulip 6.0-0, we have switched the volume storage from being in
+As of version 6.0-0, we have switched the volume storage from being in
 directories under `/opt/docker/zulip/` on the Docker host system, to using named
 Docker managed volumes. In your `docker-compose.yml`, you should either preserve
 the previous `/opt/docker/zulip/` paths for your volumes, or migrate the

compose.yaml

@@ -64,7 +64,7 @@ services:
       - "redis:/data:rw"
     attach: false
   zulip:
-    image: "zulip/docker-zulip:11.5-0"
+    image: "ghcr.io/zulip/zulip-server:11.5-0"
     restart: unless-stopped
     build:
       context: .

helm/zulip/CHANGELOG.md

@@ -1,3 +1,8 @@
+## [1.11.51] - 2026-02-06
+
+- Switch to the image at ghcr.io/zulip/zulip-server, which is compatible with
+  the chart as written.
+
 ## [1.11.50] - 2026-02-05
 
 - Switch to a new `CERTIFICATES` env var, which combines of `DISABLE_HTTPS` and

helm/zulip/Chart.yaml

@@ -44,4 +44,4 @@ dependencies:
 sources:
   - https://github.com/zulip/zulip
   - https://github.com/zulip/docker-zulip
-  - https://hub.docker.com/r/zulip/docker-zulip
+  - https://ghcr.io/zulip/zulip-server