Welcome to docker-zulip!
Image available from:
Current Zulip version:
Current Docker image version:
Quote from Zulip.Org:
Powerful open source group chat
Thanks to dropbox for Open Sourcing Zulip! - Zulip's Github
How to configure the container
See the Configuration Page for infos about configuring the container to suit your needs.
How to get the container running
To pull the image run
docker pull quay.io/galexrt/zulip:1.7.1-0
docker pull galexrt/zulip:1.7.1-0
For the latest development image run
docker pull quay.io/galexrt/zulip:dev
docker-compose.yml, before running the container!
If you don't configure it, you'll end up with a misconfigured Zulip Instance!
You need a working SMTP server for Zulip to allow the creation of the first user!
Starting the container
To start the container, you have to use either use
Don't forget to configure your
Change to the root of the source folder and use
A Kubernetes pod file is in the
kubernetes/ folder. The command to run it would be
kubectl create -f ./kubernetes/.
Creating Zulip User
To be able to create a Zulip user, you create a Realm inside Zulip.
To trigger creation of a Realm you can run:
docker-compose exec zulip /opt/createZulipRealm.sh
Follow the link you just got printed and follow the instructions to create an user account and a realm in Zulip.
After creating an user and a realm in Zulip through the link, move on to Adding User to Admins if you want to add an user to the admin group.
Adding User to Admins
For adding the created user to the admins in the realm created in Zulip.
You need to replace
REALM_ID with the lowercase name of the Realm created and the
EMAIL_ADDRESS_OF_USER with the email address of the user you created.
docker-compose exec zulip sudo -u zulip /home/zulip/deployments/current/manage.py knight -f -r REALM_ID EMAIL_ADDRESS_OF_USER
After this the user should be added to admins in the realm and you should see more settings after a reload of the Zulip webpage in your browser.
The main reason for this to happen is that you are missing a config file named
The get this file run:
// This command copy the output of file uwsgi.ini into your data volume on the host. // Replace `YOUR_ZULIP_DATA_PATH` with your path. host$ docker run --rm quay.io/galexrt/zulip:1.5.2 cat /etc/zulip/uwsgi.ini > YOUR_ZULIP_DATA_PATH/settings/etc-zulip/uwsgi.ini
- Chat with other docker-zulip users in the [![docker topic]]
IRC. On the IRC Freenode Webchat or using a client Join IRC channel server, in the #docker-zulip channel
If you find this container useful, here's how you can help:
- Help users with issues they may encounter
- Send a pull request with your awesome new features and bug fixes
Please use 4 spaces as intent in the files, Thanks!
A big thanks to everybody that sends in issues, pull request! and helps with the issues/tickets! :-)