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.

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.

$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)"

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

wget -nv -O sealights-dotnet-linux-$SL_VERSION.nupkg "$NUGET_URL/$SL_PACKAGE/$SL_VERSION"
unzip -oq sealights-dotnet-linux-$SL_VERSION.nupkg -d "./sealights-dotnet-linux-$SL_VERSION"
ln -s ./sealights-dotnet-linux-$SL_VERSION/content ./sl-dotnet-agent
echo "[Sealights] Installed version is: $(cat ./sl-dotnet-agent/version.txt)"

Download from SeaLights

$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

wget -nv -O sealights-dotnet-agent-linux.tar.gz https://agents.sealights.co/dotnetcore/latest/sealights-dotnet-agent-linux-self-contained.tar.gz
mkdir sl-dotnet-agent && tar -xzf ./sealights-dotnet-agent-linux.tar.gz --directory ./sl-dotnet-agent
echo "[Sealights] .NET Agent version is: $(cat ./sl-dotnet-agent/version.txt)"

wget -nv -O sealights-dotnet-agent-alpine.tar.gz https://agents.sealights.co/dotnetcore/latest/sealights-dotnet-agent-alpine-self-contained.tar.gz
mkdir sl-dotnet-agent && tar -xzf ./sealights-dotnet-agent-alpine.tar.gz --directory ./sl-dotnet-agent
echo "[Sealights] .NET Agent version is: $(cat ./sl-dotnet-agent/version.txt)"

CI examples

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

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/workflows/dotnet.yml

jobs:
  tests:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Download SeaLights .NET Agent
        shell: bash
        run: |
          wget -nv -O sealights-dotnet-agent-linux.tar.gz https://agents.sealights.co/dotnetcore/latest/sealights-dotnet-agent-linux-self-contained.tar.gz
          mkdir -p sl-dotnet-agent
          tar -xzf ./sealights-dotnet-agent-linux.tar.gz --directory ./sl-dotnet-agent
          echo "[Sealights] Installed version: $(cat ./sl-dotnet-agent/version.txt)"

Retrieve the agent version selected in your Settings page

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

$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"

SEALIGHTS_URL="mydomain.sealights.co"

SL_VERSION=$(curl -s -X GET "https://$SEALIGHTS_URL/api/v2/agents/dotnet/recommended" -H "accept: application/json" -H "Authorization: Bearer $SEALIGHTS_AGENT_TOKEN" -L | jq -r .agent.version)
echo "[Sealights] Selected .NET version in Dashboard settings is: $SL_VERSION"

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/

Previous.NET/C# Agent

NextScanning the build binaries

Last updated 3 months ago

Was this helpful?