summaryrefslogtreecommitdiffstats
path: root/doc/help
diff options
context:
space:
mode:
authorit33 <iantien@gmail.com>2015-10-14 15:35:14 -0700
committerit33 <iantien@gmail.com>2015-10-14 15:35:14 -0700
commit57585d6d4fa61de5d9f225f7e827e3021a791558 (patch)
treefe2ae460f43f6c7fd2750b269e35aa21730fef06 /doc/help
parentffda0839b6998b861bf6e3fa7ff5bb0b4538b90a (diff)
downloadchat-57585d6d4fa61de5d9f225f7e827e3021a791558.tar.gz
chat-57585d6d4fa61de5d9f225f7e827e3021a791558.tar.bz2
chat-57585d6d4fa61de5d9f225f7e827e3021a791558.zip
Update Slack-Import.md
Diffstat (limited to 'doc/help')
-rw-r--r--doc/help/Slack-Import.md18
1 files changed, 10 insertions, 8 deletions
diff --git a/doc/help/Slack-Import.md b/doc/help/Slack-Import.md
index 864ed0464..e790ca319 100644
--- a/doc/help/Slack-Import.md
+++ b/doc/help/Slack-Import.md
@@ -1,19 +1,21 @@
-### Slack Import (Beta)
+### Slack Import
*Note: As a SaaS service, Slack is able to change its export format quickly. If you encounter issues not mentioned in the documentation below, please let us know by [filing an issue](https://github.com/mattermost/platform/issues).*
#### Usage
-The Slack Import feature in Mattermost is in "Beta" and focus is on supporting migration of teams of less than 100 registered users. The feature can be accessed from by Team Administrators and Team Owners via the `Team Settings -> Import` menu option.
+The Slack Import feature in Mattermost is in "Beta" and focus is on supporting migration of teams of less than 100 registered users. To use:
-- **It is highly recommended that you test Slack import before applying it to an instance intended for production.** If you use Docker, you can spin up a test instance in one line (`docker run --name mattermost-dev -d --publish 8065:80 mattermost/platform`). If you don't use Docker, there are [step-by-step instructions to install Mattermost in preview mode in less than 5 minutes](../install/Docker-Single-Container.md).
+1. Generate a Slack "Export" file from **Slack > Team Settings > Import/Export Data > Export > Start Export**
+2. In Mattermost go to **Team Settings > Import > Import from Slack**. Note: Team Owner or Team Administrator role required for this.
+3. Click **Select file** to upload Slack export file and click **Import**.
+4. Emails and usernames from Slack are used to create new Mattermost accounts
+5. Slack users can activate their new Mattermost accounts by using Mattermost's Password Reset screen with their email addresses from Slack to set new passwords for their Mattermost accounts
+6. Once logged in, the Mattermost users will have access to previous Slack messages in the public channels imported from Slack.
-Mattermost currently supports the processing of an "Export" file from Slack containing account information and public channel archives from a Slack team.
+- **It is highly recommended that you test Slack import before applying it to an instance intended for production.** If you use Docker, you can spin up a test instance in one line (`docker run --name mattermost-dev -d --publish 8065:80 mattermost/platform`). If you don't use Docker, there are [step-by-step instructions](../install/Docker-Single-Container.md) to install Mattermost in preview mode in less than 5 minutes.
-- Emails and usernames from Slack are used to create new Mattermost accounts, connected to messages history in imported Slack channels. Users can activate these accounts and by going to the Password Reset screen in Mattermost to set new credentials.
-- Once logged in, users will have access to previous Slack messages shared in public channels, now imported to Mattermost.
-
-#### Limitations:
+#### Notes:
- Newly added markdown suppport in Slack's Posts 2.0 feature announced on September 28, 2015 is not yet supported.
- Slack does not export files or images your team has stored in Slack's database. Mattermost will provide links to the location of your assets in Slack's web UI.