starlight_help/src/content/docs/import-from-slack.mdx
import {Steps, TabItem, Tabs} from "@astrojs/starlight/components";
import FlattenedSteps from "../../components/FlattenedSteps.astro"; import ZulipNote from "../../components/ZulipNote.astro"; import ZulipTip from "../../components/ZulipTip.astro"; import ImportGetYourOrganizationStarted from "../include/_ImportGetYourOrganizationStarted.mdx"; import ImportHowUsersWillLogIn from "../include/_ImportHowUsersWillLogIn.mdx"; import ImportIntoASelfHostedServerDescription from "../include/_ImportIntoASelfHostedServerDescription.mdx"; import ImportIntoASelfHostedServerInstructions from "../include/_ImportIntoASelfHostedServerInstructions.mdx"; import ImportIntoAZulipCloudOrganization from "../include/_ImportIntoAZulipCloudOrganization.mdx"; import ImportSelfHostedServerTips from "../include/_ImportSelfHostedServerTips.mdx"; import ImportWorkspaceToZulip from "../include/_ImportWorkspaceToZulip.mdx"; import ImportYourDataIntoZulip from "../include/_ImportYourDataIntoZulip.mdx"; import ImportZulipCloudOrganizationWarning from "../include/_ImportZulipCloudOrganizationWarning.mdx"; import ViewImportedUsers from "../include/_ViewImportedUsers.mdx";
<ImportWorkspaceToZulip />To import your Slack organization into Zulip, you will need to take the following steps, which are described in more detail below:
<Steps> 1. [Export your Slack data](#export-your-slack-data). 1. [Import your Slack data into Zulip](#import-your-data-into-zulip). 1. [Clean up](#clean-up-after-the-slack-export) after the Slack export. 1. [Decide how users will log in](#decide-how-users-will-log-in)! </Steps>Be sure to check out the guide on moving from Slack for a walkthrough of the transition process.
Slack's data export service allows you to export all public channel messages, including older messages that may no longer be searchable under your Slack plan.
Unfortunately, Slack only allows workspaces that are on the Business+ or Enterprise Grid plans to export private channels and direct messages. Slack's support has confirmed this policy as of August 2022.
Owners of Business+ or Enterprise Grid workspaces can request special access in order to export direct message data.
<Steps>
1. Your Slack **Bot User OAuth Token**, which will be a long
string of numbers and characters starting with `xoxb-`.
</Steps>
<ImportZulipCloudOrganizationWarning />
<FlattenedSteps>
<ImportIntoASelfHostedServerInstructions />
1. To import into an organization hosted on the root domain
(`EXTERNAL_HOST`) of the Zulip installation, run the following
commands, replacing `<token>` with your Slack **Bot User OAuth Token**.
<ImportSelfHostedServerTips />
```bash "<token>"
cd /home/zulip/deployments/current
./scripts/stop-server
./manage.py convert_slack_data /tmp/slack_data.zip --token <token> --output /tmp/converted_slack_data
./manage.py import '' /tmp/converted_slack_data
./scripts/start-server
```
Alternatively, to import into a custom subdomain, run:
```bash "<token>" "<subdomain>"
cd /home/zulip/deployments/current
./scripts/stop-server
./manage.py convert_slack_data /tmp/slack_data.zip --token <token> --output /tmp/converted_slack_data
./manage.py import <subdomain> /tmp/converted_slack_data
./scripts/start-server
```
1. Follow [step 4](https://zulip.readthedocs.io/en/stable/production/install.html#step-4-configure-and-use)
of the guide for [installing a new Zulip
server](https://zulip.readthedocs.io/en/stable/production/install.html).
</FlattenedSteps>
Whether you are using Zulip Cloud or self-hosting Zulip, here are few notes to keep in mind about the import process:
| Slack role | Zulip role |
|---|---|
| Workspace Primary Owner | Owner |
| Workspace Owner | Owner |
| Workspace Admin | Administrator |
| Member | Member |
| Single Channel Guest | Guest |
| Multi Channel Guest | Guest |
| Channel creator | none |
@user joined #channel_name messages are not imported.Once your organization has been successfully imported in to Zulip, you should delete the Slack app that you created in order to export your Slack data. This will prevent the OAuth token from being used to access your Slack workspace in the future.
To prepare your organization for transitioning to Zulip, follow the guide on moving from Slack.