Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
zulip/help/export-your-organization.md

6.1 KiB
Raw Blame History

Export your organization

!!! warn ""

These instructions are specific to the hosted Zulip Cloud service.
If you're running your own server, you may be looking for our
documentation on [server export and import][export-and-import] or
[server backups][production-backups].

Zulip has high quality export tools that can be used to migrate from the hosted Zulip Cloud service to your own servers. Two types of data exports are available to all Zulip Cloud organizations:

Two additional types of data exports are available to corporate Zulip Cloud Standard and Zulip Cloud Plus customers:

Export of public data

{!admin-only.md!}

{!not-human-export-format.md!}

{start_tabs}

{settings_tab|data-exports-admin}

  1. Click Start export of public data.

  2. After a few minutes, you'll be able to download the export as a .tar.gz file from that page.

  3. Import the tarball using Zulip's logical data import tool.

!!! warn ""

Generating the export can take up to an hour for organizations
with a large number of messages or uploaded files.

{end_tabs}

Full export with member consent

{!owner-only.md!}

{!not-human-export-format.md!}

In addition to your organization's public data, this export includes all the messages received by any user in the organization who consents to the data export. In particular, it includes any private channel messages and direct messages where at least one of the recipients has given consent.

Users who do not provide consent will have their settings and stream subscriptions exported, but will have no personalized message history.

{start_tabs}

  1. Email support@zulip.com with your organization's zulipchat.com URL, asking for a full export with member consent. Please send the email from the same address that you use to sign in to Zulip, so that Zulip Support can verify that you are an owner of the organization.

  2. You will receive an email with instructions on how to collect member consent. Follow the instructions, and notify support@zulip.com when the process has been completed.

  3. You will receive an archive in the .tar.gz format containing all public information for your organization, plus private channel messages and direct messages for users who gave consent.

  4. Import the tarball using Zulip's logical data import tool.

{end_tabs}

Full export without member consent

{!owner-only.md!}

{!not-human-export-format.md!}

{!export-without-consent-requirements.md!}

{start_tabs}

  1. Email support@zulip.com with your organization's zulipchat.com URL, asking for a full export without member consent. Please send the email from the same address that you use to sign in to Zulip, so that Zulip Support can verify that you are an owner of the organization.

  2. Once your authority to request the export has been verified, you will receive an archive in the .tar.gz format containing all the information for your organization.

  3. Import the tarball using Zulip's logical data import tool.

{end_tabs}

Compliance export

{!owner-only.md!}

This type of export is recommended if you plan to work with the exported data directly (e.g., reading messages or processing them with a script), rather than importing the export into a new Zulip organization.

{!export-without-consent-requirements.md!}

{start_tabs}

  1. Email support@zulip.com asking for a compliance export. Please send the email from the same address that you use to sign in to Zulip, so that Zulip Support can verify that you are an owner of the organization. You will need to specify:

    1. The zulipchat.com URL for your organization

    2. What limits you would like on the export. Currently, compliance exports can apply any combination of the following filters:

      • Message sender
      • Message recipient
      • Message contents, by specific keywords
      • Sent timestamp before, after, or between dates

      If you need other limits, please ask.

    3. Your preferred format for the export: CSV or JSON.

    4. Whether or not you want to receive copies of all attachments referenced in the exported messages.

  2. You will receive the requested information once your authority to request the export has been verified.

{end_tabs}

Related articles