Install Chat Server

Install VNC Free Chat Server

The Chat Server has to be installed on a dedicated machine. Currently, the only supported environments are Ubuntu 14.04 server 64bit and Ubuntu 16.04 server 64bit. While installing the base operating system, use the minimal installation and only add openSSH server to it.

The installation is done by running the installer script with root privileges. During the installation process, it will interactively ask for all required information and installs & configures all components afterwards.

Getting the installer

VNC Free chat is available for download here.

After fetching the installer, extract the script from the tgz-file, make it executable and start the installation:

tar xvfz install-vnc-free-chat.tgz
sudo chmod +x ./
sudo ./

This will install quite a lot of dependencies and may take some time. We propose running the installation in a screen.

Installation process

After adding some additional package repositories and pre-installing some required components, the interactive installation process starts.

  1. In the first five screens, the installer will ask for details to access Zimbra LDAP server and the public domain name of your chat server. Whenever a default value is available or can be determined, the input is pre-filled using this default value. In addition the installer provides you with the respective zimbra commandline, to fetch the required information from the Zimbra-server:

    LDAP Hostname

    Once these details are provided, the installer checks for the required Zimbra settings and provides feedback about required modifications still pending on Zimbra side. When everything has been adjusted on zimbra-site according to the requirements, it will look like this:

    In case anything is not setup correctly, in this example JSP has not been enabled on the Zimbra-Server yet, you will be notified with a FAIL instead.

    In addition your are told, how you can modify the respective parameter:

    After fixing the issue and hitting Ok, you are prompted, if you want to perform the check again:

  2. Now the installer will create the Chat application server’s databases. If you do not want to use external databases let the installer create them automatically by selecting ”Yes” here:

  3. In the next step the commercial SSL-certificate is deployed on the chat-application server:

    Note1: The required modification and steps to generate and deploy a self-signed SSL-certificate instead, with all its limitations, is documented in section Modifications necessary when using a self-signed SSL-certificate

    In the next two screens, you will be prompted to enter the path to the certificate’s key- and certificate- file. Provide the filenames with full path to the installer here. The files will be copied to




    afterwards. The installer will only accept valid key- and certificate files and requests you to reenter the filepaths in case an error is detected.

    Enter Path to SSL-certificate Key file

    Enter Path to SSL-certificate Key file

    Enter Path to SSL-certificate file

    After the certificate path has been entered, the installer continues with the installation by downloading and installing the required packages and dependencies.

  4. Next up you will have to provide some more information about your Zimbra environment:

    Select Zimbra Access Protocol:

    Enter Zimbra Hostname:

    Enter Zimbra Admin-UI Port:

    Enter Zimbra Admin Username:

    Enter Zimbra Admin Password:

  5. Once this is done, the installer asks if the server is behind a NAT/Firewall. If you are using Split DNS AND want to enable 3rd party tools like Pidgin access to the Chat-Server, answer ”Yes” here.

    In all other cases it’s save to select ”No” here, since the Chat-server will only be accessed by Zimbra-Server.

  6. In the next two screens, you are asked if you want to use the default virtual hostnames and port settings for TURN. In most cases it is safe to answer ”Yes”. If you say ”No” here, the installer will prompt you for all the required virtual hostnames afterwards.

    Default Virtual Hostnames:

    Use Default Port for TURN:

    Now the remaining dependend packages are downloaded, installed and configured.

    When the process is finished and you selected ”Yes” when asked if the server is behind a NAT/Firewall , you are now prompted with two additional screens, asking you to enter either the external

    • IPv4 or

    • IPv6 address

    Only one IP-address type is required to enter here. The other input field could be left empty. In case the answer was ”No” when asked if the server is behind a NAT/Firewall, the next two screens are skipped and the DNS configuration is created right away.

  7. (Optional) Add external IP:

    Enter external IPv4 address:

    Enter external IPv6 address:

  8. DNS configuration created:

    which is stored as a dnsmasq.conf file as well as a bind.conf file to:



  9. After pressing ”Ok”, you will be asked if you want to check if the DNS is already setup correctly:

    If the DNS-setup is complete, you will be informed with this screen about it:

    In case not, you will be informed about the number of errors found:

    Details will be saved to the file dnserror.txt which you can find in your current working directory after the installation has been finished.

  10. Finally the required settings for admin UI are displayed:

VNC Free Chat installation (nearly) done.                                           
please visit this page and follow the instructions -
configure in Zimbra Admin UI these settings:

XMPP server URL:           https://<server-URL-forAdminUI>
XMPP server URL Port:      443
Authentication Token:      <shared secred>