Import from HipChat (beta)

Starting with Zulip 1.9, Zulip supports importing data from HipChat, including users, rooms, messages, avatars, and custom emoji.

Note: You can only import a HipChat group as a new Zulip organization. In particular, you cannot use this tool to import data from HipChat into an existing Zulip organization.

Import from HipChat

First, export your data from HipChat.

  1. Log in at yourdomain.hipchat.com/admin/.

  2. Click on the Data Export tab.

  3. Select the data to export.

  4. Click Export.

Once the export has completed, the export will be available to you in the admin console.

  1. Upgrade to the latest version to ensure you have the latest updates to the HipChat export dashboard.

  2. Log in at the domain name configured for your Hipchat Server.

  3. Click on Server Admin > Export.

  4. Select the data to export.

  5. Click Export.

Once the export has completed, you will receive an email with a link to download the file.

If you are not on the latest version of Hipchat Server / Data Center, you can do a command line export with hipchat export --export. See HipChat's command line export docs for more information.

Note: Only HipChat Group Administrators can export data from HipChat.

Import into zulipchat.com

Email support@zulipchat.com with exported HipChat archive and your desired subdomain. Your imported organization will be hosted at <subdomain>.zulipchat.com.

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

Import into a self-hosted Zulip server

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

Because the import tool is very new, you will need to upgrade your Zulip server to the latest master branch, using upgrade-zulip-from-git.

Log in to a shell on your Zulip server as the zulip user. To import with the most common configuration, run the following commands, replacing <hipchat_export_file> with the HipChat export file.

cd /home/zulip/deployments/current
./manage.py convert_hipchat_data <hipchat_export_file> --output converted_hipchat_data
./manage.py import '' converted_hipchat_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 Zulip 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.

./manage.py import <subdomain> converted_hipchat_data

Logging in

Once the import completes, all your users will have accounts in your new Zulip 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 ./manage.py send_password_reset_email command to send password reset emails to your users. We recommend starting with sending one to yourself for testing:

./manage.py send_password_reset_email -u username@example.com

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

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

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