# Downloading the .NET Core agent
The latest version of the dot net core agent can be downloaded in two archive formats to support the native capabilities of Linux (`.tar.gz`) and Windows (`.zip`). It is especially relevant when working with containers.
All the agents from the links below are provided as self-contained applications, if you need a platform dependent version, please contact Support.
{% hint style="warning" %}
When using the Alpine version of the agent, please make sure your command are referring to the “right” executable (without file extension): `SL.DotNet` instead of `SL.DotNet.exe` or `SL.DotNet.dll`.
{% endhint %}
{% hint style="info" %}
* If you have a limitation accessing the endpoint [agents.sealights.co](http://agents.sealights.co/) and are limited to your specific server's DNS, then you can also get the agent from `https://{company}.sealights.co/dotnetcore/latest/sealights-dotnet-agent-{os}-self-contained.{archive-extension}` and replace `{company}` with your company dns prefix
* The Alpine distribution uses [musl](https://en.wikipedia.org/wiki/Musl) as the standard C library implementation, while most other Linux distributions use [glibc](https://en.wikipedia.org/wiki/GNU_C_Library) as their standard C library implementation \[[Source](https://stackoverflow.com/questions/59341750/why-cant-i-run-a-c-program-built-on-alpine-on-ubuntu)]. It means the library compiled with `glibc` depends on a different set of standard libraries, leading to a separate artifact for Alpine distributions. The code base remains the same; only the build configuration is different.
{% endhint %}
## Downloading from NuGet
We’re publishing the agent also in Nuget [NuGet Gallery | sealights-technologies](https://www.nuget.org/profiles/sealights-technologies)
* Sealights.DotNet.Windows
* Sealights.DotNet.Linux
* Sealights.DotNet.Alpine
You can download the agents from there.
## Sample Scripts for download
### Download the agent from NuGet
In the script below:
* We download the `.nupkg` file, store it locally, and unzip it (`.nupkg` is a ZIP format)
* We create a symbolic link to the content subfolder to keep compatibility with “existing” script commands (referring to \`sl-dotnet-agent\`) and keep things short and simple
{% tabs %}
{% tab title="Windows Powershell" %}
{% code overflow="wrap" %}
```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)"
```
{% endcode %}
{% endtab %}
{% tab title="Linux" %}
{% endtab %}
{% endtabs %}
### Download the agent from Sealights
{% tabs %}
{% tab title="Windows Powershell" %}
{% code overflow="wrap" %}
```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] .NetCore Agent version is: $(Get-Content .\sl-dotnet-agent\version.txt)"
```
{% endcode %}
{% hint style="info" %}
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.
{% endhint %}
{% hint style="warning" %}
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`
{% endhint %}
{% endtab %}
{% tab title="Linux" %}
{% code overflow="wrap" %}
```sh
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] .NetCore Agent version is: $(cat ./sl-dotnet-agent/version.txt)"
```
{% endcode %}
{% endtab %}
{% tab title="Alpine" %}
{% code overflow="wrap" %}
```sh
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] .NetCore (Alpine) Agent version is: $(cat ./sl-dotnet-agent/version.txt)"
```
{% endcode %}
{% endtab %}
{% endtabs %}
### Retrieve the agent version selected in your Settings page
In the script below, we retrieve the version selected in the dashboard settings page
{% tabs %}
{% tab title="Windows Powershell" %}
{% code overflow="wrap" %}
```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"
```
{% endcode %}
{% endtab %}
{% tab title="Linux" %}
{% code overflow="wrap" %}
```sh
$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"
```
{% endcode %}
{% endtab %}
{% endtabs %}
## Security
If you download and copy the agent manually, its files might get blocked by Windows OS.
You have two options to unblock them, 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.
* You can also use the following PowerShell command: `Get-ChildItem -Path 'C:\Sealights\agent\' -Recurse | Unblock-File` ( assuming they were unzipped in the same `C:\Sealights\agent` folder)
{% hint style="info" %}
For more info, see:
{% endhint %}
