Downloading and Connecting HipChat Apps

This page describes how to download and connect the HipChat client apps with HipChat Server.

Downloading the HipChat apps

From HipChat Server, you can download the HipChat apps that are compatible with your HipChat Server version.

  1. Go to hipchat.example.com/downloads and choose the tab for your operating system. 
    (where hipchat.example.com is the fully qualified domain name of your HipChat Server.) 
    Note: For the iPhone/iPad app, you'll be redirected to the Apple App Store. Go ahead and download the HipChat app from there.
  2. Download the app and install it following the instructions shown in the installers.
    Note: For Linux, the instructions are on the Linux tab of the downloads page.

Connecting the Windows and Linux desktop apps

  1. Start the HipChat app.
  2. Choose Configure Connection below the Log In button.
  3. Under Connect to, select HipChat Server, then enter the fully qualified domain name of your HipChat Server. (For example, hipchat.example.com)
  4. Click OK.
  5. Log into HipChat.

Connecting the Mac OSX app

  1. Start the HipChat app.
  2. Select HipChat > Preferences > Connect using, then HipChat Server.
  3. In the Server address field, enter the fully qualified domain name of the HipChat Server. (For example, hipchat.example.com)
  4. If HipChat Server is using a signed SSL certificate, select the Require certificate validation check box. (To find out whether this is required, check with your HipChat Server admin.)
  5. Log into HipChat.

Connecting the Android app

  1. Start the HipChat app.
  2. On the Login Screen, tap .
  3. Tap HipChat Server.
  4. Enter the fully qualified domain name of the HipChat Server. (For example, hipchat.example.com)
  5. If HipChat Server is using a signed SSL certificate, select the Require certificate validation check box. (To find out whether this is required, check with your HipChat Server admin.)
  6. Tap OK, then sign in.

Connecting the iPhone / iPad app

  1. Go to your iPhone's or iPad's Settings, then scroll down until you see HipChat.
  2. Tap Connect using > HipChat Server, then tap the back arrow.
  3. Tap Server address, then enter the fully qualified domain name of the HipChat Server. (For example, enter hipchat.example.com)
  4. If HipChat Server is using a signed SSL certificate, ensure the Require certificate validation toggle is enabled (green). (To find out whether this is required, check with your HipChat Server admin.)
  5. Tap Settings to ensure the new settings are saved.
  6. Open the HipChat app and sign in.

Troubleshooting

See the HipChat Knowledge Base for help troubleshooting the HipChat apps.

Note on CentOS/RHEL/Fedora: We have had reports that the Linux HipChat client on CentOS 7 will not allow you to choose HipChat Server upon login if NetworkManager is running. We have not been able to reproduce this issue but are calling it out here just in case you hit the same issue. The workaround to execute is to stop NetworkManager.

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