zulip/help/change-organization-url.md

2.4 KiB

Change organization URL

{!owner-only.md!}

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 channel to notify users that they need to update their clients.

Change your Zulip Cloud subdomain

Zulip Cloud organizations are generally hosted at <subdomain>.zulipchat.com, with the subdomain chosen when the organization was created. Organization owners can request to change the subdomain.

{start_tabs}

Please email support@zulip.com with the following information:

  1. Your organization's current subdomain.

  2. The subdomain you would like to move your organization to.

{end_tabs}

Move to a custom URL on Zulip Cloud

{!cloud-plus-only.md!}

Because maintaining custom URLs requires effort from our operational team, this feature is available only for organizations with 25+ Zulip Cloud Plus licenses.

{start_tabs}

Please email support@zulip.com with the following information:

  1. Your organization's current URL.

  2. The URL you would like to move your organization to.

{end_tabs}

Change the URL for your self-hosted server

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.