Create the vhost.conf.json Configuration File - Fluid Topics - 3.8

Install Fluid Topics on Multiple Servers

Fluid Topics
Technical Notes

The vhost.conf.json file indicates the domain name used to reach the portal. It is used within the server, especially for emails containing access URLs to Fluid Topics (user account activation email, and so on) and for customer users database integration. When the Fluid Topics tenant is accessible through multiple domains, the main domain must be set in the vhost.conf.json file.

In the case of an on-premises installation, the vhost.conf.json file is preset and is automatically provided by means of the following installation packages given by Antidot: antidot-svc-ft-$project_name-bo, antidot-svc-ft-$project_name-idx, and antidot-svc-ft-$project_name-reply.

Fluid Topics needs to know the tenant URL.

To set the tenant URL:

  1. Create the following file on the Front and Indexing servers:

    As antidot user


  2. Add the following lines:

    "vhost": "https://$DOMAIN_NAME",
    "certFile": "$CERTIFICATE.CERT",
    "boPortal": "$BACK_OFFICE_URL"


  • $DOMAIN_NAME is the URL where the tenant portal can be accessed. It can be a server hostname (the server hosting the front environment), a server IP or a dedicated URL.
  • $CERTIFICATE.CERT is the absolute path to the complete "certificate.cert" (CA_BUNDLE) file to be used. The "certFile" parameter is optional.

If the certificate is self-signed, or signed by an authority not recognized by the operating system or the browser, the "certFile" parameter is mandatory. If the certificate is not recognized and certFile is not present, an error may occur when indexing data.

  • $BACK_OFFICE_URL is the dedicated URL where the Back Office can be accessed. For example: The URL entered here is mandatory and will be used for various queries between the Back Office and Fluid Topics user interface. Its default value is: http://localhost/bo-portal

If the "boPortal" parameter is not set, some Administration features will not work.

The tenant domain name is the responsibility of the customer.

If the tenant site is not going to use the HTTPS protocol, enter the following lines:


In a multiple-server installation, if it is set, the certificate must be present on the servers hosting the Front environment and the Indexing environment.

The documentation for all the parameters of the configuration file is available at

To consult the documentation for any other tenant, add "/configuration-doc" to the tenant's URL, for example,

In our example, the vhost.conf.json file is as follows:

"vhost": "http://oleandor:8080/1/stable",
"boPortal": "http://oleandor/bo-portal/"