Connect, update, or uninstall Hipchat client apps
This page describes how to connect the existing Hipchat apps to your Hipchat Data Center, and how to update and uninstall these clients.
To learn more about the Hipchat Data Center specific clients, check out the Hipchat Data Center beta clients page.
Wait, what app do I need?
The original Hipchat client apps work with both Hipchat Server and Hipchat Data Center - but they also work with Hipchat Cloud. This means that when you connect to your Hipchat deployment for the first time, you need to select the type of deployment (in this case Server) before you log in.
Desktop clients
Connect - macOS, Windows, Linux
- Start the Hipchat app.
- On the screen that appears, locate the lower section that says Log in to a Hipchat team server.
- In the lower section, click Get Started.
- In the Server address field, enter the fully qualified domain name of your Hipchat Data Center deployment. (For example,
hipchat.example.com) - Click Continue.
- Log into Hipchat.
Upgrade - macOS, Windows
On macOS and Windows, the Hipchat desktop client notifies you when an upgrade is available. Follow the prompts in the notification message to upgrade the app.
If you didn't upgrade when you were notified, you can also do the following:
- In the Hipchat menu bar at the top of your screen, click Hipchat > Check for Updates.
If an update is available, the Software Update window appears showing the release notes for the version you're updating to. Otherwise, a message appears telling you that Hipchat is up to date. - If an update is available, follow the prompts on the screen to upgrade Hipchat.
Upgrade - Linux
If you're on Linux, Hipchat is a standard package, and you can refer to your specific Linux distribution documentation for upgrade instructions.
Uninstall Hipchat clients
Uninstalling the Hipchat app doesn't delete your Hipchat account or any data associated with your group. It only removes the app from your device.
Uninstall on macOS
- Quit the Hipchat application.
- Open Finder > Applications. A list of applications appears.
- Click and drag the Hipchat application to the trash.
Uninstall on Windows 7, Windows 8, and Vista
- Click the Start menu.
- Windows 7 and Vista: Click Control Panel.
- Windows 8: Click Settings > Control Panel.
- Click Uninstall a Program.
- Right-click Hipchat, then select Uninstall.
Uninstall Hipchat on Linux
Hipchat is a standard package. Refer to your specific Linux distribution documentation for uninstallation instructions.
Mobile clients
The Hipchat mobile clients are generally managed on the device using the app store or management app for the platform. To update a mobile client, visit the entry on the platform's
Android mobile client
The Android OS runs on many different devices, including mobile phones and some tablets.
Connecting the Android app
- Start the Hipchat app.
- Tap Log in to Hipchat Server. (We know it says Server, but it means Data Center too!)
- Enter tthe fully qualified domain name of your organization's Hipchat Data Center deployment. (For example,
hipchat.example.com) - If your Hipchat Data Center instance is using a signed SSL certificate, select the Require certificate validation check box. (To find out whether this is required, check with your Hipchat admin.)
- Tap OK, then sign in.
Uninstalling the Android app
There are multiple ways to remove apps. Here's one way:
- Open the Google Play Store app.
- Tap the Menu icon, then My Apps.
- Tap the Hipchat app, then tap Uninstall.
iOS mobile client
You can use the iOS mobile client to chat on iPhone and iPad devices.
Connecting the iOS app
- Start the Hipchat app.
- Tap Log in to Hipchat Server. (We know it says Server, but it means Data Center too!)
- Tap Server address, then enter the fully qualified domain name of your organization's Hipchat Data Center deployment. (For example, enter
hipchat.example.com) - If your Hipchat Data Center instance 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 admin.)
- Tap Next, and continue to sign in.
Uninstalling the iOS app
There are multiple ways to remove apps. Here's one way:
- Tap and hold the Hipchat app's icon for a moment, then let go. The app icons start moving and a gray "x" icon appears in each icon's corner.
- Tap the "x" icon on the Hipchat app.
- Tap Delete to confirm you want to delete the app.
Troubleshooting
You can find information and tips for troubleshooting client issues in the Hipchat Knowledge Base.
.