Video Chat and Screen Sharing
This page describes the HipChat Server video chat implementation.
Disable all video chat
If you don't want to use video chat or screen sharing, you can disable it for all users.
Log in to HipChat Server and go to Server admin > Video.
You can also perform this from the CLI by running the hipchat video --disable command. For example:
Turn on HipChat Video
To use HipChat Video go to Server admin > Video and choose HipChat Video.
For HipChat Server 2.0.7 or earlier:
For HipChat Server 2.2.2:
To start a video chat, all participants need will need to be running version 4.26 or later of the HipChat desktop client (Mac, Linux or Windows).
If you are currently using AddLive for video, HipChat Video will be turned on automatically when you upgrade to HipChat 2.1 or later, or you can choose to switch to HipChat Video now.
For HipChat Server 2.0.7 or earlier, please run:
For HipChat Server 2.2.x, please run:
The video conferencing capabilities are implemented using WebRTC, and both the clients and server must have a working internet connection. HipChat Server sets up the connections between the two HipChat clients' users. Once the session is established, audio and video streams using the HipChat Video service hipchat.me.
The following ports need to be open for HipChat Video:
- TCP port 443 open for connections from HipChat clients and HipChat Server.
- UDP port 10000 open for HipChat clients.
All video chat is routed through hipchat.me, our Cloud video solution. If this is an issue for your organisation you can disable video chat for all users. Only the clients need connectivity to hipchat.me.
HipChat Server also needs to register with the video service hosted in video.hipchatserver.com to establish a trust - based on a combination of a public/private key and your HipChat Server license. Connectivity to video.hipchatserver.com from the server instance is only needed while turning HipChat Video on or off. Once HipChat Video is set up, we do not communicate with video.hipchatserver.com.
To check connectivity with the keyserver using the CLI, run:
To check if the key server has your server key, run:
What is transmitted from HipChat Server?
- No user-provided credentials are transmitted.
- The full name of the user, their ID (email address) and their avatar URL are transmitted.
- The domain name of the HipChat Server is transmitted.
How is information encrypted?
All signaling communications are encrypted using cipher suites restricted to AES 128 or 256 bit encryption.
Video and audio data streams are protected using the SRTP protocol. AES CPC 128 bit encryption is used for RTP packet encryption. HMAC SHA1 is used for packet authentication and verification. Encryption keys are generated by the streaming server by session.
To use HipChat Video, all participants must be running version 4.26 or later of the HipChat desktop client (Mac, Linux or Windows), and must have a working internet connection. Video chat is not available in mobile clients.
The Windows and Linux client apps require a graphics driver that provides OpenGL 2.1 or higher.
To use HipChat Video in the web client, browsers will need to allow popups from your HipChat site.
Safari users will also be prompted to download and install the Temasys WebRTC Plugin before they can join a video chat. This plugin is required by Jitsi, the technology that powers HipChat Video, as Safari does not have native WebRTC support.
Troubleshooting HipChat Video
If users are reporting that they can't see the video button in their client, or they see an 'unable to join call' error, here's some things to try.
- Go to Server admin > Video and check that HipChat video is enabled. If you see an error when you try to enable HipChat Video, make sure that HipChat Server can reach
- Check which version of the HipChat desktop client the user has installed. They'll need version 4.2.7 or later to use HipChat video. HipChat video is not available on any mobile clients.
- Ask the user to log out of their HipChat client completely, then log back in. If they are using the macOS X client, they'll also need to hit Forget this account after they log out.
Additional Troubleshooting Resources
- HipChat SDK does not support audio/video calls on 64 bit chips mobile device
Was this helpful?
Thanks for your feedback!