---
title: "Legacy - LiveDesign on-premise"
slug: "connector-ld-spo-admin-guides-ld-onprem"
updated: 2026-09-22T13:12:17Z
published: 2026-09-22T13:12:17Z
canonical: "docs.discngine.com/connector-ld-spo-admin-guides-ld-onprem"
---

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

# Legacy - LiveDesign on-premise

The following installation and upgrade procedures to **deploy the Spotfire Connector Gadget application** are based on a legacy LiveDesign on-premise installation using nginx as application server. For the following steps, we assume you have SSH access to your LiveDesign server. Note that you might need sudo rights on the LiveDesign server.

## Installation

1. Copy the content of the `web` folder from the LiveDesign Connector package to the server, under seurat/custom_gagdets directory:

```
scp -r /path/to/web <user>@<ld_server_url>:/home/seurat/custom_gadgets/ldconnector
```

1. Edit the config file

Use your favourite editor to open the file `/home/seurat/custom_gadgets/ldconnector/config/config.json`

```
{
  "authentication": {
    "liveDesignSessionUri": "/livedesign/session"
  },
  "visualizer": {
    "url": "<spotfire-url-host-with-protocol>",
    "entryPointDocumentIdOrPath": "df7b5c3b-935c-4dde-b102-54f44b3b6a6b"
  },
  "data": {
    "liveDesignServerUrl": "<livedesign-url-host-with-protocol>"
  }
}
```

- Set your Spotfire server url in the **> visualizer > url** property, e.g. "https://spotfire.mycompany.com"
- Set the id of the entry point document in the **> visualizer > entryPointDocumentIdOrPath** property (see below for details). The entry point document is the default document that will be used to check the connection to Spotfire. **We strongly suggest to use the *empty* document provided in the LDConnector.part0.zip file.**
- Set the LiveDesign url in the **> data > liveDesignServerUrl** property, e.g. 'https://livedesign.mycompany.com"

To get the id of the default entry point document:

- Go to the Spotfire administration website in **Library > Browse**
- Open the `/LDConnector/Project 0/Default` folder and click on **Copy link** for the `empty` document
- Take the id of the document from the link and use it as `entryPointDocumentIdOrPath`

![Get Entry Point Document ID](https://connector.discngine.com/images-doc360/ld_spo/administration/spotfire_entry_point.png)

1. Check that the ownership and access rights are correct:

```
sudo chown seurat:seurat -R /home/seurat/custom_gadgets/ldconnector/
# if required:
sudo chmod 755 -R /home/seurat/custom_gadgets/ldconnector/
```

1. Create/edit the nginx configuration to expose two locations

Go to the nginx config folder:

```
cd /etc/nginx/endpoints.d
```

Create a new config file for the Discngine configuration and open it with your favourite editor:

```
touch discngine.conf
vi discngine.conf
```

Then paste the following piece of code:

```
location = /livedesign/session {
    default_type text/plain;

    if ( $http_cookie ~ "JSESSIONID=(?<token>[^;]*)" ) {
        return 200 $1;
    }
    return 401;
}

location /livedesign/spo {
    alias /home/seurat/custom_gadgets/ldconnector/;
    index index.html;
}
```

Save your file and restart nginx:

```
sudo systemctl restart nginx
```

## Upgrade

The procedure is similar to the installation procedure.

1. SSH to your LiveDesign server.
2. Backup the previously installed gadget directory.
3. Copy the content of the `web` folder from the LiveDesign Connector package to the server, under `seurat/custom_gagdets` directory:

```
scp -r /path/to/web <user>@<ld_server_url>:/home/seurat/custom_gadgets/spotfire
```

1. Replace the file in `/home/seurat/custom_gadgets/spotfire/config/config.json` by the config.json file from the backed up folder.
2. Check that the ownership and access rights are correct:

```
sudo chown seurat:seurat -R /home/seurat/custom_gadgets/spotfire/
# if required:
sudo chmod 755 -R /home/seurat/custom_gadgets/spotfire/
```