Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
zulip/templates/zerver/help/import-data-from-slack.md

2.9 KiB
Raw Blame History

Import data from Slack (beta)

Starting with Zulip 1.8, Zulip supports importing data from Slack, including users, channels, messages, attachments, avatars, custom emoji, and emoji reactions.

!!! warn "" These instructions require shell access to the Zulip server. If you'd like to import a Slack organization into the hosted zulipchat.com service, contact support@zulipchat.com.

  1. Export your Slack data. You will receive a zip file slack_data.zip.

    !!! warn "" Note: Only Slack owners and admins can export data from Slack. See Slack's guide to data exports for more information.

  2. Generate a Slack API token.

Import into a new Zulip instance

Log in to your Zulip server as the zulip user. Run the following commands, replacing <token> with the value generated above:

cd ~/zulip
./manage.py convert_slack_data slack_data.zip --token <token> --output converted_slack_data
./manage.py import --destroy-rebuild-database '' converted_slack_data

!!! warn "" Warning: This will destroy all existing data in your Zulip instance.

Import into an existing Zulip instance

Log in to your Zulip server as the zulip user. Run the following commands, replacing <token> with the value generated above, and <subdomain> with the subdomain of the URL you'd like for your imported Zulip organization.

cd ~/zulip
./manage.py convert_slack_data slack_data.zip --token <token> --output converted_slack_data
./manage.py import --import-into-nonempty <subdomain> converted_slack_data

Caveats

  • Slack doesn't export private channels or direct messages unless you pay for Slack Plus or contact Slack support. See Slack's documentation for more details.

  • (Slack Plus import) Private channels and direct messages are currently not imported. We expect to address this in a future revision.

  • (Slack Plus import) Message edit history is currently not imported.

  • Slack doesn't export user settings or organization settings, so you'll need to configure these manually.

  • User phone numbers and custom user profile fields are not currently imported. We expect to address this in a future revision.

  • Permission hierarchy: Slack's Primary owner, owner, and admin are mapped to Zulip's Organization admin. Slack's Member, restricted, and ultra restricted are mapped to regular Zulip users. Channel creators have no special permissions in Zulip.

  • The "joined #channel_name" messages are not imported.

  • The import tool does not support simultaneous bold and italic formatting of a word; we expect to address this in a future revision.