Files
zulip/help/change-organization-url.md
Lauryn Menard fc810655e6 help: Rename "roles-and-permissions.md" to "manage-permissions.md".
Renames file and redirects existing links to "help/user-roles" as
the previous content tracks to that current file's content.

Updates existing links (excluding ReadtheDocs) to go to either
"help/user-roles" or "help/manage-permissions" depending on which
help center article applies to the content.
2024-12-11 12:02:11 -08:00

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.