Files
zulip/help/change-organization-url.md
Lauryn Menard dedea23745 help-docs: Move help center documentation to top level directory.
These files are not Jinja2 templates, so there's no reason that they needed
to be inside `templates/zerver`. Moving them to the top level reflects their
importance and also makes it feel nicer to work on editing the help center content, 
without it being unnecessary buried deep in the codebase.
2023-01-25 14:08:29 -08:00

1.7 KiB

Change organization URL

Zulip supports changing the URL for an organization. Changing the organization URL is a disruptive operation for users:

  • Users will be logged out of existing sessions on the web, mobile and desktop apps and need to log in again.
  • Any API clients or integrations will need to be updated to point to the new organization URL.

We recommend using a wildcard mention in an announcement stream to notify users that they need to update their clients.

If you're using Zulip Cloud (E.g. https://example.zulipchat.com), you can request a change by emailing support@zulip.com. Custom domains (i.e. those that do not have the form example.zulipchat.com) have a maintenance cost for our operational team and thus are only available for paid plans.

Self-hosting

If you're self-hosting, you can change the root domain of your Zulip server by changing the EXTERNAL_HOST setting. If you're hosting multiple organizations and want to change the subdomain for one of them, you can do this using the change_realm_subdomain management command.

In addition to configuring Zulip as detailed here, you also need to generate SSL certificates for your new domain.