> For the complete documentation index, see [llms.txt](https://sealights-docs.tricentis.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sealights-docs.tricentis.com/sealights-agents-and-plugins/abap-agent/command-line-interface/set-up-the-agent.md).
# Set up the agent
{% hint style="warning" %}
**Upgrading from an older agent version?** The current agent requires configuration version 2. If your `config.toml` uses an older format, the agent will prompt you to migrate. Follow the steps in [Migrate a legacy configuration](/sealights-agents-and-plugins/abap-agent/command-line-interface/set-up-the-agent/migrate-a-legacy-configuration.md) to upgrade your `config.toml`.
{% endhint %}
## Prerequisite to Agent Setup
To check connectivity to Sealights, run the following from your terminal (replace the `{customerId}` with your customer id beforehand):
{% tabs %}
{% tab title="Command Prompt" %}
{% code overflow="wrap" lineNumbers="true" %}
```batch
curl -I https://{customerId}.sealights.co
```
{% endcode %}
{% endtab %}
{% tab title="PowerShell" %}
{% code overflow="wrap" lineNumbers="true" %}
```powershell
Test-NetConnection {customerId}.sealights.co -Port 443
Invoke-WebRequest https://{customerId}.sealights.co
```
{% endcode %}
{% endtab %}
{% endtabs %}
## Set up the agent
To set up the ABAP agent, run the following from your terminal:
## List the agent's settings
To list the ABAP agent's ABAP settings, run the following from your terminal:
{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}
```batch
slabapcli.exe settings list
```
{% endcode %}
{% endtab %}
{% tab title="PowerShell" %}
{% code title="Command" overflow="wrap" %}
```powershell
.\slabapcli.exe settings list
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}
```log
.\slabapcli.exe settings list
[2025-06-20 10:22:48.782+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-20 10:22:48.782+01:00] [info] Config pathname: ../config/config.toml
[2025-06-20 10:22:48.785+01:00] [info] Install dir : C:\Program Files\Tricentis\SeaLights\ABAP Agent\bin
[2025-06-20 10:22:48.786+01:00] [info] User data dir : ..\userdata
[2025-06-20 10:22:48.786+01:00] [info] Key : 01000000d08c9ddf0115d1118c7a00c04fc297eb01000000b4f1adcc9afb9a41849a2ac77c60e16b04...c035668c57485ce5
[2025-06-20 10:22:48.786+01:00] [info] IV : 00283e66c6697b9ddb9047a3363e06bf
[2025-06-20 10:22:48.787+01:00] [info] Total time: 00:00:00.005
```
{% endcode %}
The command-line interface shows encrypted keys in the **settings list** output.
## Connect the agent to your SeaLights environment
The next step is to connect the agent to your SeaLights environment. You can do this as follows:
### Copy your SeaLights agent token
First you'll need to copy your SeaLights agent token to the clipboard, as follows:
1. In a web browser, navigate to the URL for your SeaLights dashboard.
2. Select the **Settings** icon, and then select **Agent Tokens** from the **Settings** menu's **Cockpit & Onboarding** section.
3. Locate the entry for your agent token, and press the **Copy token** button to copy it to the clipboard. Be sure to copy a token whose status is active.
### Connect the agent to SeaLights
Next, you'll need to connect the agent to SeaLights using the command-line interface. You can do this as follows:
* Run the following command from your terminal:
## List the SeaLights token
To list the SeaLights token in encrypted form, run the following from your terminal:
{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}
```batch
slabapcli.exe sealights list
```
{% endcode %}
{% endtab %}
{% tab title="PowerShell" %}
{% code title="Command" overflow="wrap" %}
```powershell
.\slabapcli.exe sealights list
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}
```log
.\slabapcli.exe sealights list
[2025-06-17 09:03:34.867+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-17 09:03:34.867+01:00] [info] Config pathname: ../config/config.toml
Hostname: dev-abap-integration-5-gw.dev.sealights.co
Clock sync hostname: dev-staging.dev.sealights.co
Token : ********
Customer id: SeaLights
```
{% endcode %}
## Test the connection to SeaLights
{% hint style="info" %}
The `sealights set` command above already ran a connectivity test automatically. Use `sealights test` only if you need to re-verify connectivity later without changing the token.
{% endhint %}
## Add a proxy
If connection fails your organization might be using a proxy, if that's the case use the following to set it up:
{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}
```batch
slabapcli.exe proxy set --server "http://proxy.example.com:8080" --auth
```
{% endcode %}
{% endtab %}
{% tab title="PowerShell" %}
{% code title="Command" overflow="wrap" %}
```powershell
.\slabapcli.exe proxy set --server 'http://proxy.example.com:8080' --auth
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}
```log
.\slabapcli.exe proxy set --server 'http://proxy.example.com:8080' --auth
Enter proxy username: user1
Enter proxy password:
[2025-10-20 13:45:22.714+02:00] [info] Proxy configuration saved successfully.
```
{% endcode %}
## Validate your complete setup
After configuring all components (SeaLights, RFC destinations, and pipelines), run the setup status command to verify everything in one step:
{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}
```batch
slabapcli.exe setup status
```
{% endcode %}
{% endtab %}
{% tab title="PowerShell" %}
{% code title="Command" overflow="wrap" %}
```powershell
.\slabapcli.exe setup status
```
{% endcode %}
{% endtab %}
{% endtabs %}
For details on reading the report, see [Validate Your Setup](/sealights-agents-and-plugins/abap-agent/command-line-interface/validate-your-setup.md).