> ## Documentation Index
> Fetch the complete documentation index at: https://support.lilt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Custom Domain And Certificates

## 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](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.

```bash theme={null}
$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:

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:

```yaml theme={null}
front:
  onpremValues:
    env:
      CORE_API_URL: "https://your-domain/core/api"
```

Review all other mentions of bare.lilt.com in `lilt/values.yaml`, and create analogous entries in `lilt/environments/environments/values.yaml` with your domain name.

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:

```bash theme={null}
/install_dir/nginx-ingress/on-prem-values.yaml
```

Configure the public and private keys (crt and key, respectively) in the following file:

```bash theme={null}
/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`

```bash theme={null}
/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](https://your-domain.com/signin)