You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: source/onboard/migrate-from-slack.rst
+8-6
Original file line number
Diff line number
Diff line change
@@ -56,6 +56,7 @@ When you download your Slack export zip file, some data will be missing from the
56
56
57
57
- User emails
58
58
- Uploaded attachment contents
59
+
- Profile pictures
59
60
60
61
We need to create a Slack app in order to gather these contents. Follow these steps to create a Slack app:
61
62
@@ -73,23 +74,24 @@ We need to create a Slack app in order to gather these contents. Follow these st
73
74
8. Grant the app permissions when prompted.
74
75
9. Copy the **Bot User OAuth Token** and save it somewhere convenient.
75
76
76
-
We'll now use **Bot User OAuth Token** with the ``slack-advanced-exporter`` tool to download emailsand attachments. Download the latest release of ``slack-advanced-exporter`` for your OS and architecture `here <https://github.com/grundleborg/slack-advanced-exporter/releases/>`__ and extract the executable from the download.
77
+
We'll now use **Bot User OAuth Token** with the ``slack-advanced-exporter`` tool to download emails, attachments and profile pictures. Download the latest release of ``slack-advanced-exporter`` for your OS and architecture `here <https://github.com/wetneb/slack-advanced-exporter/releases/>`__ and extract the executable from the download.
77
78
78
79
Once you have the program downloaded locally, run the commands below to fetch the emails, and then fetch file attachments. Replace ``<SLACK TOKEN>`` with the Slack token you generated earlier and ``<SLACK EXPORT FILE>`` with the `path <https://www.geeksforgeeks.org/absolute-relative-pathnames-unix/>`__ to your export file.
- The first command collects all of the user emails and creates the file ``export-with-emails.zip``. The second command fetches attachments and creates the file ``export-with-emails-and-attachments.zip``, which we will use going forward.
89
+
- The first command collects all of the user emails and creates the file ``export-with-emails.zip``. The second command downloads the profile pictures and creates the file `export-with-profile-pictures.zip`. The third command fetches attachments and creates the file ``export-with-everything.zip``, which we will use going forward.
88
90
- The second command can take a long time if you have a large number of file uploads. If it's interrupted, delete the file generated (if any), and start again.
89
91
90
-
The file ``export-with-emails-and-attachments.zip`` now contains all the information necessary to be imported into Mattermost.
92
+
The file ``export-with-everything.zip`` now contains all the information necessary to be imported into Mattermost.
91
93
92
-
It's preferable to fetch e-mails first to avoid copying large attachments around. Make sure you choose different file names at each stage, as the tool does not support in-place modifications.
94
+
It's preferable to fetch attachments last to avoid copying large attachments around. Make sure you choose different file names at each stage, as the tool does not support in-place modifications.
93
95
94
96
.. important::
95
97
@@ -98,7 +100,7 @@ It's preferable to fetch e-mails first to avoid copying large attachments around
98
100
4. Convert Slack import to Mattermost's bulk export format
Now that you have a Slack export file with emails and attachments, let's convert this information into Mattermost's bulk import format using the import preparation tool ``mmetl``. Download the latest release of ``mmetl`` for your `OS and architecture <https://github.com/mattermost/mmetl/releases/>`__. Run ``mmetl help`` to learn more about using the tool.
103
+
Now that you have a Slack export file with emails, profile pictures and attachments, let's convert this information into Mattermost's bulk import format using the import preparation tool ``mmetl``. Download the latest release of ``mmetl`` for your `OS and architecture <https://github.com/mattermost/mmetl/releases/>`__. Run ``mmetl help`` to learn more about using the tool.
102
104
103
105
Next, run the following command to create a Mattermost bulk import file. Replace ``<TEAM-NAME>`` with the name of your team in Mattermost. Note that the name needs to be one word like "my-team".
0 commit comments