3.3 KiB
Import 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.
First, you need to do some things in Slack to setup the export:
-
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.
Import into zulipchat.com
Email support@zulipchat.com with slack_data.zip
, the Slack API token
generated above, and your desired subdomain. Your imported organization will
be hosted at <subdomain>.zulipchat.com
.
Import into a new Zulip server
!!! warn ""
Because the Slack import tool is very new, we recommend first
upgrading your new Zulip server to the latest master
branch,
using upgrade-zulip-from-git to avoid
bugs in the earliest versions of the Slack import tool.
Log in to a shell on your Zulip server as the zulip
user. Run the
following commands, replacing <token>
with the value generated
above:
cd /home/zulip/deployments/current
./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 server
Import into an existing Zulip server
If you already have some organizations hosted on your Zulip server, and want to add import your Slack data as a new Zulip organization, you can use the following procedure.
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 /home/zulip/deployments/current
./manage.py convert_slack_data slack_data.zip --token <token> --output converted_slack_data
./manage.py import --import-into-nonempty <subdomain> converted_slack_data
{!import-login.md!}
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.
-
Permission hierarchy: Slack's
Primary owner
,owner
, andadmin
are mapped to Zulip'sOrganization admin
. Slack'sMember
,restricted
, andultra restricted
are mapped to regular Zulip users.Channel creators
have no special permissions in Zulip. -
The "joined #channel_name" messages are not imported.