Downloading the .NET agent

Download the SeaLights .NET Agent as a self-contained package or from NuGet.

The latest .NET Agent is available as self-contained packages for Windows, Linux, and Alpine.

Use the self-contained packages when you want the agent to run without relying on a locally installed .NET runtime.

The public artifact endpoint still uses dotnetcore in the URL path. That path is expected.

If you need a platform-dependent package, contact Support.

OS	Download link	Minimum System Requirements
Windows	https://agents.sealights.co/dotnetcore/latest/sealights-dotnet-agent-windows-self-contained.zip	Windows 10 build 17063 (and higher)
Linux	https://agents.sealights.co/dotnetcore/latest/sealights-dotnet-agent-linux-self-contained.tar.gz	Ubuntu 20.04 (and higher), Debian 11 (and higher), RHEL 8.10 (and higher)
Alpine	https://agents.sealights.co/dotnetcore/latest/sealights-dotnet-agent-alpine-self-contained.tar.gz	Alpine 3.18 (and higher)

When using the Alpine version, run the executable without an extension: SL.DotNet.

• If you cannot access agents.sealights.co, use https://{company}.sealights.co/dotnetcore/latest/sealights-dotnet-agent-{os}-self-contained.{archive-extension} and replace {company} with your company DNS prefix.
• Alpine uses musl, while most Linux distributions use glibc. That is why Alpine has a separate artifact.

Downloading from NuGet

The agent is also published on NuGet Gallery | sealights-technologies.

• Sealights.DotNet.Windows
• Sealights.DotNet.Linux
• Sealights.DotNet.Alpine

You can download the platform package that matches your environment.

Sample scripts

Download from NuGet

These examples download the package, extract it locally, and create a short sl-dotnet-agent path.

PowerShell

$SL_PACKAGE = "Sealights.DotNet.Windows"
$NUGET_URL = "https://www.nuget.org/api/v2/package"
$SL_VERSION = "3.13.0"

$packageName = "sealights-dotnet-windows-$SL_VERSION.nupkg"
$extractPath = "./sealights-dotnet-windows-$SL_VERSION"

Invoke-WebRequest -Uri "$NUGET_URL/$SL_PACKAGE/$SL_VERSION" -OutFile $packageName -UseBasicParsing
Expand-Archive -Path $packageName -DestinationPath $extractPath -Force
New-Item -ItemType SymbolicLink -Path "./sl-dotnet-agent" -Target "$extractPath/content" -Force | Out-Null

Write-Output "[Sealights] Installed version is: $(Get-Content ./sl-dotnet-agent/version.txt)"

Bash

Download from SeaLights

PowerShell

$global:ProgressPreference = "SilentlyContinue"
iwr -OutFile sealights-dotnet-agent.zip -UseBasicParsing -Uri https://agents.sealights.co/dotnetcore/latest/sealights-dotnet-agent-windows-self-contained.zip
Expand-Archive .\sealights-dotnet-agent.zip -DestinationPath sl-dotnet-agent -Force
Write-Output "[Sealights] .NET Agent version is: $(Get-Content .\sl-dotnet-agent\version.txt)"

You can deploy the token as a file in the agent folder automatically via a command like: Out-File -InputObject $SL_AGENT_TOKEN -NoNewline -Force (Join-Path .\sl-dotnet-agent\ "sltoken.txt") This will allow you to save the token parameter from the agent's commands.

In some Windows configurations, it may be necessary for you to enforce a compatible SSL protocol [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 -bor [Net.SecurityProtocolType]::Tls13

Bash

Alpine Bash

CI examples

Use these examples when you want to download the agent inside the pipeline itself.

Azure DevOps

azure-pipelines.yml

steps:
  - pwsh: |
      $ProgressPreference = "SilentlyContinue"
      Invoke-WebRequest `
        -Uri "https://agents.sealights.co/dotnetcore/latest/sealights-dotnet-agent-windows-self-contained.zip" `
        -OutFile "sealights-dotnet-agent.zip" `
        -UseBasicParsing
      Expand-Archive ".\sealights-dotnet-agent.zip" -DestinationPath ".\sl-dotnet-agent" -Force
      Write-Host "[Sealights] Installed version: $(Get-Content .\sl-dotnet-agent\version.txt)"
    displayName: Download SeaLights .NET Agent

GitHub Actions

Retrieve the agent version selected in your Settings page

These examples retrieve the version selected in the dashboard settings page.

PowerShell

$SEALIGHTS_URL = "mydomain.sealights.co"
$headers = @{
    accept = "application/json"
    Authorization = "Bearer $env:SEALIGHTS_AGENT_TOKEN"
}
$version = (Invoke-RestMethod "https://$SEALIGHTS_URL/api/v2/agents/dotnet/recommended" -Headers $headers).agent.version
Write-Output "[Sealights] Selected .NET version in Dashboard settings is: $version"

Bash

Security

If you download and copy the agent manually, its files might get blocked by Windows OS.

You have two options to unblock them:

• Right-click both the SL.DotNet.exe and SL.DotNet.dll files and check the Unblock check box in the security section.
• Use this PowerShell command: Get-ChildItem -Path 'C:\Sealights\agent\' -Recurse | Unblock-File

For more info, see: https://mywindowshub.com/how-to-unblock-a-file-in-windows-10/