Welcome to docker-zulip!
Image available from:
Current Zulip version: 1.8.1
Current Docker image version: 1.8.1-0
This is a container image for Zulip.
Quote from Zulip.Org:
Powerful open source group chat
Requirements
Zulip recommends at least about 1.9GB RAM on the machine you are running on.
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.8.1-0
or
docker pull galexrt/zulip:1.8.1-0
For the latest development image run
docker pull quay.io/galexrt/zulip:dev
Configure your 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!
Check the wiki page on how to configure the image, here. Wiki Page
Starting the container
To start the container, you have to use either use docker-compose or kubernetes:
Don't forget to configure your docker-compose.yml properly!!
Using docker-compose
Change to the root of the source folder and use docker-compose up.
Using Kubernetes
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 sudo -H -u zulip -g zulip /home/zulip/deployments/current/manage.py generate_realm_creation_link
Follow the link you just got printed and follow the instructions to create an user account and a realm in Zulip.
Troubleshooting
zulip-django exited
The main reason for this to happen is that you are missing a config file named uwsgi.ini.
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
Community
Chat with other docker-zulip users on the chat.zulip.org. The stream/channel is #production-help.
Contributing
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! :-)