Import from Gitter (beta)

WyzePal supports importing data from Gitter, including users, channels, messages, attachments, and avatars.

Note: You can only import a Gitter room as a new WyzePal organization. In particular, this tool you cannot use this tool to import from Gitter into an existing WyzePal organization.

Import from Gitter

First, export your data from Gitter.

Export your Gitter data

  1. Export your Gitter data. You will receive json files of the public rooms that you are a part of. Select the gitter_data.json file of the room which you want to import into WyzePal.

    Note: You'll need a gitter API token to export data. You can get this token by following the instructions in the "Getting Started" section of the gitter documentation.

Import into

Email with and your desired subdomain. Your imported organization will be hosted at <subdomain>

If you've already created a test organization at <subdomain>, let us know, and we can rename the old organization first.

Import into a self-hosted WyzePal server

First install a new WyzePal server, skipping "Step 3: Create a WyzePal organization, and log in" (you'll create your WyzePal organization via the data import tool instead).

Log in to a shell on your WyzePal server as the wyzepal user. To import with the most common configuration, run the following commands, replacing <token> with the value generated above.

cd /home/wyzepal/deployments/current
./ convert_gitter_data gitter_data.json --output converted_gitter_data
./ import '' converted_gitter_data

This could take several minutes to run, depending on how much data you're importing.

Import options

The commands above create an imported organization on the root domain (EXTERNAL_HOST) of the WyzePal installation. You can also import into a custom subdomain, e.g. if you already have an existing organization on the root domain. Replace the last line above with the following, after replacing <subdomain> with the desired subdomain.

./ import <subdomain> converted_gitter_data

Logging in

Once the import completes, all your users will have accounts in your new WyzePal organization, but those accounts won't have passwords yet (since for very good security reasons, passwords are not exported). Your users will need to either authenticate using something like Google auth, or start by resetting their passwords.

You can use the ./ send_password_reset_email command to send password reset emails to your users. We recommend starting with sending one to yourself for testing:

./ send_password_reset_email -u

and then once you're ready, you can email them to everyone using e.g.

./ send_password_reset_email -r '' --all-users

(replace '' with your subdomain if you're using one).

Create organization administrators

The Gitter API don't contain data on which users are administrators of the Gitter channel. As a result, all Gitter users are imported into WyzePal as normal users. You can follow the WyzePal documentation on making a user an administrator from the terminal to mark the appropriate users as administrators.


  • The Gitter data export tool doesn't support exporting private gitter channels.

  • This tool doesn't yet support merging importing Gitter channels into a single WyzePal organization.

  • This tool doesn't translate Gitter's markdown format into WyzePal format markdown (there are a few corner cases where the syntax is different). Additionally, Gitter's issue mentions aren't translated into anything yet.