2016-08-18 02:51:04 +02:00
|
|
|
# Customize Zulip
|
2016-07-12 22:43:00 +02:00
|
|
|
|
|
|
|
|
Once you've got Zulip setup, you'll likely want to configure it the
|
2017-07-28 03:51:22 +02:00
|
|
|
way you like.
|
|
|
|
|
|
|
|
|
|
## Making changes
|
|
|
|
|
|
|
|
|
|
Most configuration can be done by a realm administrator, on the web.
|
|
|
|
|
For those settings, see [the documentation for realm
|
|
|
|
|
administrators][realm-admin-docs].
|
2017-06-08 22:28:51 +02:00
|
|
|
|
|
|
|
|
[realm-admin-docs]: https://zulipchat.com/help/getting-your-organization-started-with-zulip
|
2017-05-16 22:28:15 +02:00
|
|
|
|
2017-07-28 03:51:22 +02:00
|
|
|
This page discusses additional configuration that a system
|
|
|
|
|
administrator can do. To change any of the following settings, edit
|
|
|
|
|
the `/etc/zulip/settings.py` file on your Zulip server, and then
|
|
|
|
|
restart the server with the following command:
|
|
|
|
|
```
|
|
|
|
|
su zulip -c /home/zulip/deployments/current/scripts/restart-server
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Specific settings
|
2017-06-09 05:59:07 +02:00
|
|
|
|
2017-07-28 03:51:22 +02:00
|
|
|
### Authentication Backends
|
2017-06-09 05:59:07 +02:00
|
|
|
|
|
|
|
|
`AUTHENTICATION_BACKENDS` is a list of enabled authentication mechanisms. By
|
|
|
|
|
default the email backend is enabled.
|
|
|
|
|
|
|
|
|
|
If you want an additional or different authentication backend, you will need to
|
|
|
|
|
uncomment one or more and then do any additional configuration required for
|
|
|
|
|
that backend as documented in the `settings.py` file. See
|
|
|
|
|
the [section on Authentication](prod-authentication-methods.html) for more detail on the available
|
|
|
|
|
authentication backends and how to configure them.
|
|
|
|
|
|
2017-07-28 03:51:22 +02:00
|
|
|
### Mobile and desktop apps
|
2017-05-16 22:28:15 +02:00
|
|
|
|
|
|
|
|
The Zulip apps expect to be talking to to servers with a properly
|
|
|
|
|
signed SSL certificate, in most cases and will not accept a
|
|
|
|
|
self-signed certificate. You should get a proper SSL certificate
|
|
|
|
|
before testing the apps.
|
|
|
|
|
|
|
|
|
|
Because of how Google and Apple have architected the security model of
|
|
|
|
|
their push notification protocols, the Zulip mobile apps for
|
|
|
|
|
[iOS](https://itunes.apple.com/us/app/zulip/id1203036395) and
|
|
|
|
|
[Android](https://play.google.com/store/apps/details?id=com.zulip.android)
|
|
|
|
|
can only receive push notifications from a single Zulip server. We
|
|
|
|
|
have configured that server to be `push.zulipchat.com`, and offer a
|
|
|
|
|
[push notification forwarding service](prod-mobile-push-notifications.html) that
|
|
|
|
|
forwards push notifications through our servers to mobile devices.
|
|
|
|
|
Read the linked documentation for instructions on how to register for
|
|
|
|
|
and configure this service.
|
|
|
|
|
|
|
|
|
|
By the end of summer 2017, all of the Zulip apps will have full
|
|
|
|
|
support for multiple accounts, potentially on different Zulip servers,
|
|
|
|
|
with a convenient UI for switching between them.
|
2016-07-12 22:43:00 +02:00
|
|
|
|
2017-07-28 03:51:22 +02:00
|
|
|
### Terms of service and Privacy policy
|
2017-04-10 12:55:43 +02:00
|
|
|
|
|
|
|
|
Zulip allows you to configure your server's Terms of Service and
|
|
|
|
|
Privacy Policy pages (`/terms` and `/privacy`, respectively). You can
|
|
|
|
|
use the `TERMS_OF_SERVICE` and `PRIVACY_POLICY` settings to configure
|
|
|
|
|
the path to your server's policies. The syntax is Markdown (with
|
|
|
|
|
support for included HTML). A good approach is to use paths like
|
|
|
|
|
`/etc/zulip/terms.md`, so that it's easy to back up your policy
|
|
|
|
|
configuration along with your other Zulip server configuration.
|
|
|
|
|
|
2017-07-28 03:51:22 +02:00
|
|
|
### Miscellaneous server settings
|
2016-08-09 23:31:22 +02:00
|
|
|
|
2017-05-16 22:28:15 +02:00
|
|
|
Zulip has dozens of settings documented in the comments in
|
|
|
|
|
`/etc/zulip/settings.py`; you can review
|
|
|
|
|
[the latest version of the settings.py template][settings-py-template]
|
|
|
|
|
if you've deleted the comments or want to check if new settings have
|
|
|
|
|
been added in more recent versions of Zulip.
|
2016-07-12 22:43:00 +02:00
|
|
|
|
2017-05-16 22:28:15 +02:00
|
|
|
Since Zulip's settings file is a Python script, there are a number of
|
|
|
|
|
other things that one can configure that are not documented; ask on
|
|
|
|
|
[chat.zulip.org](https://zulip.readthedocs.io/en/latest/chat-zulip-org.html)
|
|
|
|
|
if there's something you'd like to do but can't figure out how to.
|
2016-07-12 22:43:00 +02:00
|
|
|
|
2017-05-16 22:28:15 +02:00
|
|
|
[settings-py-template]: https://github.com/zulip/zulip/blob/master/zproject/prod_settings_template.py
|
2016-07-12 22:43:00 +02:00
|
|
|
|
2017-05-16 22:28:15 +02:00
|
|
|
## Zulip announcement list
|
2016-08-09 23:31:22 +02:00
|
|
|
|
2017-05-16 22:28:15 +02:00
|
|
|
If you haven't already, subscribe to the
|
|
|
|
|
[zulip-announce](https://groups.google.com/forum/#!forum/zulip-announce)
|
|
|
|
|
list so that you can receive important announces like new Zulip
|
|
|
|
|
releases or major changes to the app ecosystem..
|
2016-07-12 22:43:00 +02:00
|
|
|
|
2017-02-03 21:56:33 +01:00
|
|
|
## Enjoy your Zulip installation!
|
2016-08-09 23:31:22 +02:00
|
|
|
|
2017-02-03 21:56:33 +01:00
|
|
|
If you discover things that you wish had been documented, please
|
|
|
|
|
contribute documentation suggestions either via a GitHub issue or pull
|
|
|
|
|
request; we love even small contributions, and we'd love to make the
|
|
|
|
|
Zulip documentation cover everything anyone might want to know about
|
|
|
|
|
running Zulip in production.
|
2016-07-12 22:43:00 +02:00
|
|
|
|
|
|
|
|
Next: [Maintaining and upgrading Zulip in
|
2016-07-12 22:52:29 +02:00
|
|
|
production](prod-maintain-secure-upgrade.html).
|
