Archive Your Mattermost Conversations

1. Download the latest release of mattermost-exporter for your platform and operating system. On Linux and MacOS you might need to mark the downloaded file as executable: chmod +x mattermost-exporter.
2. Get a personal access token from Mattermost.
3. Create a file called .env in the same folder you put mattermost-exporter, with the following content:

MATTERMOST_URL="https://matters.teamusec.de"
MATTERMOST_API_TOKEN="<the access token you just created>"

4. Run mattermost-exporter. If you encounter any errors while exporting your Mattermost data, please try to rerun the tool and see whether it throws the same error. Sometimes the tool runs into rate-limits, and just needs to restart. This will create a ./data directory in your current folder. If you received messages after you've run this command, you can run mattermost-exporter --update to just download posts in channels that had new posts since the last download, without having to download all posts and files in all channels again.

5. Download mm-archive-viewer.html.

6. Open mm-archive-viewer.html in your browser (tested with Chrome, but Firefox, Opera, etc. should work too).

7. Click on Select Your Archive, and choose the previously created ./data directory. This will display all your channels and direct messages across all teams you previously had on Mattermost.

8. If everything looks good, you can now delete .env and mattermost-exporter. All you need in the future are ./data and mattermost-archive.html.

Look Behind the Scences

mattermost-exporter is the product of main.ts, which is compiled with Deno.

mm-archive-viewer.html is the product of a Vue application that is compiled to a single HTML page.

For Admins

Have a look at the admin folder. You will find some scripts that might be helpful, e.g., to allow all users to create personal access tokens after you've enabled the feature on the server.