Unblu 4.1

On Premise Requirements

1. Server Software Requirements

1.1. Unblu Collaboration Server

1.1.1. Minimal Java Version

Unblu collaboration server needs Java Version 7 or higher to run.

1.1.2. Minimal Servlet API Version

Unblu collaboration server supports Servlet API Version 2.5 or higher.

1.1.3. Servlet Container

Unblu collaboration server is built to be deployed to any Servlet Container that supports Servlet API Version 2.5 or higher running on Java 7 or higher. Recommended containers

1.2. Unblu Rendering Service

Some optional modules like unblu document co-browsing or universal co-browsing require the unblu rendering service to be installed in addition. The unblu rendering service is based on docker ( It requires a separate host to run docker with the rendering service docker image available at

Please see Enable universal and document co-browsing for all details about the unblu rendering service installation.

2. Network Requirements

2.1. Unblu Collaboration Server Requirements

The unblu collaboration server needs to be accessible for the visitor and agents. In minimal configuration, the server does not communicate with other servers and thus does not require Internet access.

If additional modules are deployed the following sections for their particular network connectivity requirements apply.

2.2. Universal and Document co-browsing Requirements

The optional unblu document co-browsing component requires the unblu collaboration server to be installed with the above Software Requirements. In addition, the unblu rendering service is required.

The unblu collaboration server must be able to communicate with the unblu rendering service via SSH protocol on port 22.

The unblu rendering service must be able to communicate with the unblu collaboration server on 80 and 443 in both directions (inbound and outbound). Please note, that no proxy must be between these two servers, or the proxy must support the WebSocket protocol.

2.3. Video / Audio Chat Requirements

These are the requirements to use the optional unblu Video / Audio Chat component:

2.3.1. Server communication

The unblu collaboration server must be able to communicate with which is a service located on the Internet. Thus, port 443 must be open for outbound traffic to

2.3.2. Browser communication Browser requirements

Running Unblu's audio / video service requires WebRTC support which is provided by the following Browsers:

  • Google Chrome (latest release version)
  • Firefox (latest release version)
  • Internet Explorer 10 and 11 (with the Plugin for InternetExplorer provided at the start of a audio / video chat)
  • Google Chrome for Android (latest release version)
  • Firefox for Android (latest release version) Firewall Requirements

Running Unblu's audio / video service requires the Browser to access the audio / video chat services over specific ports in order to work. A network administrator in your organization can configure these firewall settings:

Minimum Requirement: The minimum Requirement is that TCP port 443 is open. Some firewall/proxy rules only allow for SSL traffic over port 443. You will need to make sure that non-web traffic can also pass over this port.

Better Experience: In addition to the minimum requirements being met, we also recommend that UDP port 3478 is open.

Best Experience: For the best possible experience, we recommend that UDP ports 1025 - 65535 be open.

You can test if a network meets the connectivity requirements by using the OpenTok Connectivity Doctor: (you must use Chrome). There is also a Connectivity Doctor app in the Apple App Store as well as the Google Play Store. Bandwidth requirements

  • Video: 300 kbps per stream (recommended lowest level)
  • Audio: 50 kbps per stream (recommended lowest level)

3. Browser Requirements

3.1. Desktop Browsers

Unblu is optimized to run on modern browsers. Supported browsers are:

  • Internet Explorer 9 (or newer)
  • Google Chrome 40 (or newer)
  • Apple Safari 7 (or newer)
  • Mozilla Firefox 30 (or newer)

3.2. Mobile

3.2.1. iOS Tablets

Safari on iOS 7 (or newer)

In page chat UI renders top right of viewport

3.2.2. Android Tablets

Chrome on Android 4.2+

In page chat UI renders top right of viewport

3.2.3. Smartphones

Android (Chrome) and iOS supported in principal. Usability restrictions apply for small screens.

4. Server Hardware Recommendations

4.1. Unblu Collaboration Server

A single server setup (optionally with a hot standby) is the most robust, lowest cost to maintain solution to run a co-browsing infrastructure. To accommodate 10-20 concurrent co-browsing sessions (this means active usage of co-browsing in parallel), the following minimal requirements apply:

  • 10 GB harddrive
  • 1 Recent CPU core with 2.4GHz or higher
  • 4 GB RAM
  • 4 Mbit bandwidth

Any additional 10-20 concurrent sessions require 1 additional core, 4 additional GB of RAM, and 4 additional Mbit of bandwidth.

With the outlined specs below, it's possible to scale up to 250 concurrent sessions. In our experience with existing large scale clients in the financial services space, 250 concurrent sessions support up to 2500 agent seats. We recommend to run a fully productive server with a hot standby configuration to cover redundancy.

  • Recent 16 core CPU with 2.4GHz or better
  • 64 GB RAM
  • Gigabit Ethernet or fibre channel Network
  • SSD (min 100 GB available space on top of OS)