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.
- HipChat Cloud
- HipChat Server or Data Center
Log in at
Click on the Data Export tab.
Select the data to export.
Once the export has completed, the export will be available to you in the
Upgrade to the latest version to ensure you have the latest updates to
the HipChat export dashboard.
Log in at the domain name configured for your Hipchat Server.
Click on Server Admin > Export.
Select the data to 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 [email protected] with exported HipChat archive and your desired
subdomain. Your imported organization will be hosted at
If you've already created a test organization at
<subdomain>.zulipchat.com, let us know, and we can rename the old
Import into a self-hosted Zulip server
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
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.
./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
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
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:
and then once you're ready, you can email them to everyone using e.g.
./manage.py send_password_reset_email -r '' --all-users
'' with your subdomain if you're using one).