Upgrading HipChat Server from version 1.3 to 2.x via export/import option


since our instance of HipChat Server is behind the firewall, it's not a trivial task to get IT Security approval to change the FW rules, would this work as a 'workround' upgrade:

  1. Download new version of HipChat Server 2.x (ova)
  2. Export chat history from HC v1.3, power it off
  3. Deploy HC v2.x
  4. Import chat history
  5. Set the server for external MS AD directory (this hopefully, being done after step 4, will maintain internally assigned user IDs as they were on old server)
  6. Contact Attlansian to re-map existing license file to the new server's ID
  7. Test
  8. Decommission old HC server


I'd be really grateful if you could review these steps and let me know if it looks ok, or if not, what could be missing there.


Kind regards,




2 answers

0 votes
David Maye Atlassian Team Jan 20, 2017

Hi Jasenko,

Yes, those steps look correct. Have you considered the offline upgrade? https://confluence.atlassian.com/hipchatkb/how-to-perform-offline-upgrades-in-hipchat-server-826878852.html

The reason I ask is that the export archive only contains messages, users/user data, and rooms/room data and specifically excludes integrations, passwords, API tokens, and server settings (as dictated at Exporting and Importing your HipChat data).

Running the offline upgrade is an easier solution (be sure to snap-shot your instance before upgrading!) than standing up a fresh install.


HipChat Server Support Engineer | Atlassian


Thanks David, will try offline upgrade first after reading your answer.


Kind regards,

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Aug 10, 2018 in Hipchat

What should I think about when migrating HipChat to Slack?

...from the beginning. We have built up a lot of content in HipChat, with it being a core tool in our distributed company model. While it is true that we didn’t need to move to Slack immediately, we felt it...

592 views 2 11
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you