Upgrading HipChat Server

This page provides instructions on upgrading HipChat Server and is intended for IT administrators.


We offer two software update channels: production and Beta. Typically, the production update channel is older than the Beta channel. By default, you get the production channel when you upgrade. You can choose to upgrade to the Beta channel.

You can upgrade HipChat Server through the HipChat web app or CLI.

The HipChat Server upgrade process will also install new OS packages if the release contains any.

Upgrading using the web app

Before you start upgrading, back up HipChat Server and check our end of support announcements for changes that may impact you.


  1. Open a web browser and browse to the URL for your HipChat server web app. For example, browse to https://hipchat.yourcompany.com/
  2. Click the Server admin tab at the top.
  3. Click the Upgrade tab.  A message states whether your system is up to date.
  4. Optional: If you want to upgrade to the Beta channel, click Beta, then Change upgrade channel.
  5. Click Upgrade to the latest version.
    A message appears informing you HipChat users will be disconnected temporarily while you upgrade.
  6. Click OK.

Upgrading using the CLI

Before you start upgrading, back up HipChat Server.

To check whether HipChat Server is up to date:

hipchat upgrade --check

To view the current upgrade channel:

hipchat upgrade --show

To set the current upgrade channel to the Beta channel:

hipchat upgrade --channel beta

To set the current upgrade channel to the production channel:

hipchat upgrade --channel production

To upgrade using the current channel:

hipchat upgrade --upgrade

Using an outbound proxy server

Setting an outbound proxy server is optional.

If your company requires use of a Proxy Server for outbound network traffic, you can configure HipChat Server to check for updates using an outbound proxy server. 

Enter the following commands in the CLI:

hipchat upgrade --proxy http://user:password@proxy.example.com:portnumber

hipchat upgrade --check

hipchat upgrade --upgrade

If your proxy server does client SSL certificate validation, make sure to install your certificate prior to running the upgrade.


Sometimes there are hiccups in the internet/network and the checking for upgrade or upgrading fails. To retry an upgrade, use the following command:

hipchat upgrade --force-upgrade

(warning) You may also want to review the external directory setup (if you have configured this on the instance) after the upgrade and ensure that everything is working as expected.

For more troubleshooting information, see Connectivity Issues When Upgrading and the HipChat Server Knowledge Base.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport