zulip/templates/zerver/help/export-your-organization.md

3.3 KiB

Export your organization

{!admin-only.md!}

!!! warn "" These instructions are specific to the hosted zulipchat.com service. If you're running your own server, you may be looking for our documentation on server export and import or server backups.

Zulip has high quality export tools that can be used to migrate from the hosted Zulip Cloud service (zulipchat.com) to your own servers. There are three types of zulipchat.com exports.

  • Public export: An export of all users, settings, and all the data that appears in public streams.
  • Full export with member consent: Everything in public export, plus all the private data of members that opt-in to the export.
  • Full export without member consent: All the data in the organization.

All organizations have access to the first two kinds of export. Only corporate Zulip Standard customers have access to full export without member consent.

Public export

{start_tabs}

{settings_tab|data-exports-admin}

  1. Click Start public export.

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

{end_tabs}

Note that generating the export can take up to an hour for organizations with lots of messages or uploaded files.

{start_tabs}

  1. Email support@zulipchat.com with your zulipchat.com subdomain, asking for a full export with member consent. Email us from the same address that you use to sign in to Zulip.

  2. We will verify that you are an organization administrator, and email you instructions on how to collect member consent.

{end_tabs}

Note that such an export will include all the messages received by any user in the organization that consents to the data export. In particular, it will include all public stream content and any private stream or private message content where at least one of the participants gives consent.

Users who do not provide consent will have their settings and stream subscriptions exported, but will otherwise be treated as new users after import.

This export is limited to paid Zulip Standard customers, though in rare cases may be available to other organizations in case of due legal process.

To start this export, email support@zulipchat.com with your zulipchat.com subdomain, asking for a full export without member consent.

You'll also need to email us evidence that you have authority to read members' private messages. Typically, this will be because the zulipchat.com subdomain is administered by a corporation, and you are an official representative of that corporation. By requesting and approving this export, you will also assume full legal responsibility that the appropriate employment agreements and corporate policy for this type of export are in place. Note that many countries have laws that require employers to notify employees of their use of such an export.