Testing LILT installation for the first time

By default, the self-managed installation configures the bare.lilt.com subdomain with the corresponding certificates. Once the LILT installation is complete and all the LILT apps are running correctly, you should be able to access the front-end by mapping the IP of the worker node on your local machine to bare.lilt.com (in Linux distributions, /etc/hosts is often the main file that holds such mappings). The new entry at /etc/hosts, will be similar to this:
34.121.21.233 bare.lilt.com
Once that’s done, as a quick test, you could ping the URL bare.lilt.com, and you should get the IP of the node. If that’s correct and the LILT apps are running properly, you should be able to go to the browser and enter the following: https://bare.lilt.com/signin

1. Configuring a custom domain

Pre-requisites:**
  • To set a custom domain, as our apps are configured with TLS by default, you will need to create certificates (PEM format) as well.
  • Configure an A record for your domain to point to the worker node IP.

Please note that from here on, we will refer to the directory in which the release (.zip) was uncompressed as “install_dir.” Edit the keys host and hostWebhook and SESSION_COOKIE_DOMAIN from the following file replacing the default values with your domain without https://. The default for both fields will be bare.lilt.com.
$install_dir/lilt/environments/lilt/values.yaml
If you do not yet have these entries in $install_dir/lilt/environments/lilt/values.yaml, find the path from $install_dir/lilt/values.yaml and insert into $install_dir/lilt/environments/lilt/values.yaml before updating. NOTE: From LILT versions lilt-enterprise-2024.02.08 or later, you will also need to update the following values:
1) In the file lilt/environments/environments/values.yaml , add/edit the key CORE_API_URL replacing the default value of bare.lilt.com with your domain:
front:
  onpremValues:
    env:
      CORE_API_URL: "https://your-domain/core/api"
2) In the file $install_dir/api/on-prem-values.yaml , replace all instances of the default value bare.lilt.com with your domain.

To reflect the previous changes, a helm upgrade will be necessary (STEP 3 of this procedure).

2. Configuring custom certificates

  • Please note that it needs to be base64-encoded and all in one line, as in the example.
Configure the public and private keys (cert and key, respectively) in the following file:
/install_dir/nginx-ingress/on-prem-values.yaml
Configure the public and private keys (crt and key, respectively) in the following file:
/install_dir/lilt/environments/lilt/values.yaml

3. Re-run the installation scripts so that the changes are reflected.

Run the script install-lilt.sh
/install_dir/install-lilt.sh

4. Verify that the new domain is working correctly by entering the following URL into your browser:

If the configuration was done correctly, and the DNS record was set to point to the worker node IP, you should be able to reach: https://your-domain.com/signin