On this page you will find Tutorials, How-Tos and Tips for developing with open bi.

How to deal with connection problems in Web Configurator

This post shall help you troubleshoot login problems to your openbi instance when using the Web Configurator, available at

In general, we advise you to use secure https connections for any communications with the openbi server.

To use https for Web Configurator connections, you have to:

  1. install an https certificate on the openbi server
  2. set the configuration parameter CONFIG_USE_HTTPS to X
You must restart the open bi server after saving the server settings!

Then, on the login screen of Web Configurator, you simply activate the HTTPS option. This is not only more secure but also automatically troubleshoots most of the issues below.

After switching to https, you must always use the hostname instead of "localhost" to connect, even on the server itself!

Logo does not disappear

Depending on your internet connection, it might take up to a minute until Web Configurator displays the login screen, when opened for the first time. This is because Web Configurator uses very modern technology and downloads several libraries to be able to do so.

If the bi excellence logo does not disappear at all, security settings of your organization may prevent Web Configurator to startup correctly. You can check this by opening the Developer Tools of your Web Client and checking the Console for error messages.

If you find error messages in the console and your IT administrators cannot change the security settings in a way to prevent these errors, you are advised to install and use the Desktop Configurator instead.

Failed to fetch

The "Failed to fetch" message is shown especially if you want to reach an openbi instance via its IP address or over HTTP.

Modern browsers like Chrome do not allow insecure connection from a secure context, e.g. the configurator uses HTTPS but the server does use HTTP.

You have two options to fix this:
  1. Allow insecure content for about://settings/content/siteDetails?
  2. Set up https for the openbi instance (see above)
Thilo Knötzele
Author: Thilo Knötzele
Creation date: 07.11.2022
Category: Installation & Configuration
back to overview