Go to file
Tim Abbott 2fb9560476 puppet: enterprise=>voyager for single-server configuration.
(imported from commit 7cc47ac7c470239cd00f69cfd3137b39a0d06e3a)
2015-09-24 22:40:59 -07:00
analytics Simplify analytics code to not filter certain low-interest users/realms. 2015-09-19 23:42:28 -07:00
api Change API example usernames to use example.com domain. 2015-09-19 18:12:02 -07:00
assets Allow enterprise deployments to disable the use of Gravatar. 2013-11-18 11:48:53 -05:00
bin logging: Log management commands that are run. 2013-11-20 14:31:08 -05:00
bots Remove certain hardcoded email addresses in Zephyr mirroring. 2015-09-20 00:36:12 -07:00
confirmation enterprise => voyager 2015-08-21 10:33:35 -07:00
corporate Remove corporate beta signup form 2015-08-20 18:40:34 -07:00
docs docs: Cleanup new feature tutorial and note unfinished. 2015-09-22 22:38:55 -07:00
node_modules Upgrade handlebars to 1.3.0. 2014-01-15 16:07:20 -05:00
puppet puppet: enterprise=>voyager for single-server configuration. 2015-09-24 22:40:59 -07:00
scripts puppet: enterprise=>voyager for single-server configuration. 2015-09-24 22:40:59 -07:00
static Clarify the left_side_userlist comment. 2015-09-19 23:39:54 -07:00
templates Make clear the meaning of the colors in Zulip Dev Login. 2015-09-22 21:21:43 -07:00
tools Don't include zulip-dropbox.png in open source project. 2015-09-24 22:40:59 -07:00
zerver Set limits for export tool. 2015-09-24 19:34:28 -07:00
zilencer Modernize management command for deactivating a realm. 2015-09-19 19:10:27 -07:00
zproject Move API super users configuration into the database. 2015-09-20 11:13:20 -07:00
.gitattributes enterprise: Don't include templates/zilencer in our tarballs 2013-11-15 11:53:49 -05:00
.gitignore Add dev-secrets.conf generated by latest version of dev VM to gitignore 2015-08-20 17:33:17 -07:00
LICENSE Add license not referring to Zulip Enterprise license agreement. 2013-11-14 11:16:15 -05:00
README.md Add missing --interface option for run-dev.py. 2015-09-24 19:34:28 -07:00
README.prod.md Rename zulip-enteprise.{key,combined-chain.crt} to drop -enterprise. 2015-09-24 19:08:52 -07:00
Vagrantfile Run provision.py as a provisioner. 2015-08-19 21:07:22 -07:00
manage.py logging: Log management commands that are run. 2013-11-20 14:31:08 -05:00
provision.py Revert "Install git pre-commit hooks in the vm as part of provisioning." 2015-09-24 22:59:27 -04:00
requirements.txt Remove OpenID authentication 2015-08-20 23:52:48 -07:00
zulip_tools.py Move su_to_zulip into zulip_tools.py 2013-11-13 16:56:59 -05:00

README.md

Installing the Zulip Development environment

Using Vagrant

This is the recommended approach, and is tested on OS X 10.10 as well as Ubuntu 14.04.

Once that's done, simply change to your zulip directory and run vagrant up in your terminal. That will install the development server inside a Vagrant guest.

Once that finishes, you can run the development server as follows: vagrant ssh -- -L9991:localhost:9991

Now inside the container

cd /srv/zulip source /srv/zulip-venv/bin/activate ./tools/run-dev.py --interface=''

You can now visit http://localhost:9991/ in your browser. To get shell access to the virtual machine running the server, use vagrant ssh.

(A small note on tools/run-dev.py: the --interface='' option will make the development server listen on all network interfaces. While this is correct for the Vagrant guest sitting behind a NAT, you probably don't want to use that option when using run-dev.py in other environments).

The run-dev.py console output will show any errors your Zulip development server encounters. It runs on top of Django's "manage.py runserver" tool, which will automatically restart the Zulip server whenever you save changes to Python code.

By hand

Install the following non-Python dependencies:

  • libffi-dev — needed for some Python extensions
  • postgresql 9.1 or later — our database (also install development headers)
  • memcached (and headers)
  • rabbitmq-server
  • libldap2-dev
  • python-dev
  • redis-server — rate limiting
  • tsearch-extras — better text search

On Debian or Ubuntu systems: sudo apt-get install libffi-dev memcached rabbitmq-server libldap2-dev redis-server postgresql-server-dev-all libmemcached-dev

If on 12.04 or wheezy:

sudo apt-get install postgresql-9.1 wget https://dl.dropboxusercontent.com/u/283158365/zuliposs/postgresql-9.1-tsearch-extras_0.1.2_amd64.deb sudo dpkg -i postgresql-9.1-tsearch-extras_0.1.2_amd64.deb

If on 14.04:

sudo apt-get install postgresql-9.3 wget https://dl.dropboxusercontent.com/u/283158365/zuliposs/postgresql-9.3-tsearch-extras_0.1.2_amd64.deb sudo dpkg -i postgresql-9.3-tsearch-extras_0.1.2_amd64.deb

If on 15.04 or jessie:

sudo apt-get install postgresql-9.4 wget https://dl.dropboxusercontent.com/u/283158365/zuliposs/postgresql-9.4-tsearch-extras_0.1_amd64.deb sudo dpkg -i postgresql-9.4-tsearch-extras_0.1_amd64.deb

Then, all versions:

pip install -r requirements.txt ./scripts/setup/configure-rabbitmq ./tools/postgres-init-db ./tools/do-destroy-rebuild-database

To start the development server: ./tools/run-dev.py

… and hit http://localhost:9991/.

Running the test suite

One-time setup of test databases: ./tools/postgres-init-test-db ./tools/do-destroy-rebuild-test-database

Run all tests: ./tools/test-all

This runs the linter plus all of our test suites; they can all be run separately (just read tools/test-all to see them). You can also run individual tests, e.g.: ./tools/test-backend zerver.test_bugdown.BugdownTest.test_inline_youtube ./tools/test-js-with-casper 10-navigation.js

Possible issues

The Casper tests are flaky on the Virtualbox environment (probably due to some performance-sensitive races). Until this issue is debugged, you may need to rerun them to get them to pass.

When running the test suite, if you get an error like this: sqlalchemy.exc.ProgrammingError: (ProgrammingError) function ts_match_locs_array(unknown, text, tsquery) does not exist LINE 2: ...ECT message_id, flags, subject, rendered_content, ts_match_l... ^ … then you need to install tsearch-extras, described above. Afterwards, re-run the init*-db and the do-destroy-rebuild*-database scripts.

Contributing to Zulip

Zulip welcomes all forms of contributions!

Before a pull request can be merged, you need to to sign the Dropbox Contributor License Agreement.

Please run the tests (tools/test-all) before submitting your pull request.

Zulip has a growing collection of developer documentation including detailed documentation on coding style available on Read The Docs.

Zulip also has a development discussion mailing list

Feel free to send any questions or suggestions of areas where you'd love to see more documentation to the list!

We recommend sending proposals for large features or refactorings to the zulip-devel list for discussion and advice before getting too deep into implementation.

Please report any security issues you discover to support@zulip.com.

Running Zulip in production

This is documented in https://zulip.org/server.html and README.prod.md.