Getting Started

Prerequisites

SeaLights Account: Active SeaLights account with access credentials
Authentication Token: Valid SeaLights Agent token (stored as sltoken.txt or injected via environment variable)
Supported Go Version: The SeaLights Go Agent maintains support in line with what Golang itself supports, which is generally "from 2 versions ago" (At the time of this writing, Go 1.24+)
Go Agent Binary: Downloaded slgoagent binary placed in your project directory
Network Access: Ability to connect to SeaLights servers (check firewall/proxy settings if needed)

Downloading the Go Agent

The SeaLights Go Agent is distributed as a binary archive. Download and extract it to your project directory before proceeding.

Using an internal artifact repository? If your organization mirrors SeaLights agents in an internal repository (such as JFrog Artifactory, Nexus, or alike), replace the download URL with your internal repository endpoint. The download path structure remains the same.

Choosing a Download Strategy

Strategy

When to use

Latest

Quick start, dev/sandbox environments, POC

Specific version ⭐

Production pipelines — set via API (recommended) or hardcoded

Architecture: Set SL_OS_ARCH to match your runner or local machine:

linux-amd64 — Linux x86-64 (most CI runners)
linux-arm64 — Linux ARM64 (AWS Graviton, self-hosted ARM runners)
darwin-amd64 — macOS Intel
darwin-arm64 — macOS Apple Silicon (M1/M2/M3)

Direct Download Links (Latest)

For convenience, the table below contains direct links to the latest version of the SeaLights Go Agent:

Architecture

V2 Download Link

Linux

x86-64

https://agents.sealights.co/slgoagent/latest/slgoagent-linux-amd64.tar.gz

Linux

ARM64

https://agents.sealights.co/slgoagent/latest/slgoagent-linux-arm64.tar.gz

macOS

x86-64

https://agents.sealights.co/slgoagent/latest/slgoagent-darwin-amd64.tar.gz

macOS

ARM64

https://agents.sealights.co/slgoagent/latest/slgoagent-darwin-arm64.tar.gz

Strategy 1: Always Download the Latest Version

Suitable for development environments where you always want the newest capabilities and can tolerate potential breaking changes between runs.

SL_OS_ARCH=linux-amd64   # Set to match your runner architecture
SL_DOMAIN="<your-custom-domain>.sealights.co"   # Replace with your account domain

echo "[SeaLights] Downloading Go Agent (latest)..."
wget -nv -O slgoagent.tar.gz \
  https://${SL_DOMAIN}/agents/slgoagent/latest/slgoagent-${SL_OS_ARCH}.tar.gz

tar -xzf slgoagent.tar.gz && rm -f slgoagent.tar.gz
echo "[SeaLights] Installed: $(./slgoagent -v 2>/dev/null | grep version)"

- name: Download SeaLights Go Agent (latest)
  shell: bash
  env:
    SL_OS_ARCH: linux-amd64   # Set to match your runner architecture
    SL_DOMAIN: "<your-custom-domain>.sealights.co"   # Replace with your account domain
  run: |
    echo "[SeaLights] Downloading Go Agent (latest)..."
    wget -nv -O slgoagent.tar.gz \
      https://${SL_DOMAIN}/agents/slgoagent/latest/slgoagent-${SL_OS_ARCH}.tar.gz
    tar -xzf slgoagent.tar.gz && rm -f slgoagent.tar.gz
    echo "[SeaLights] Installed: $(./slgoagent -v 2>/dev/null | grep version)"

SL_OS_ARCH=darwin-arm64   # darwin-arm64 for Apple Silicon, darwin-amd64 for Intel
SL_DOMAIN="<your-custom-domain>.sealights.co"   # Replace with your account domain

echo "[SeaLights] Downloading Go Agent (latest)..."
curl -sSL -o slgoagent.tar.gz \
  https://${SL_DOMAIN}/agents/slgoagent/latest/slgoagent-${SL_OS_ARCH}.tar.gz

tar -xzf slgoagent.tar.gz && rm -f slgoagent.tar.gz
echo "[SeaLights] Installed: $(./slgoagent -v 2>/dev/null | grep version)"

Strategy 2: Specific Version (Recommended)

Tip: For production pipelines, leave SL_AGENT_VERSION empty in the snippet below to automatically resolve (via API call) the version your administrator has approved in the Dashboard settings dedicated page.

When the approved version changes, every pipeline picks it up automatically on the next run — no edits required.
When troubleshooting, set it to latest or pin it to a specific version (e.g. v2.0.225).

API Endpoint:

GET https://{DOMAIN}/api/v2/agents/slgoagent/recommended/version

Authentication: Authorization: Bearer <your-agent-token>
Response: JSON object with a version field, e.g. {"version": "v2.0.225"}

SL_OS_ARCH=linux-amd64   # linux-amd64 | linux-arm64 | darwin-amd64 | darwin-arm64
SL_DOMAIN="<your-custom-domain>.sealights.co"   # Replace with your account domain
SL_TOKEN=$(cat ./sltoken.txt)                    # Or inject via secret/env var
SL_AGENT_VERSION=""   # Set to "latest", "vX.Y.Z" to pin, or leave empty to use API

if [ -z "${SL_AGENT_VERSION}" ]; then
  echo "[SeaLights] Resolving recommended version from dashboard..."
  SL_AGENT_VERSION=$(curl -sSf \
    -H "Authorization: Bearer ${SL_TOKEN}" \
    "https://${SL_DOMAIN}/api/v2/agents/slgoagent/recommended/version" \
    | grep -o '"version":"[^"]*"' | cut -d'"' -f4)
fi

echo "[SeaLights] Resolved version: ${SL_AGENT_VERSION}"
wget -nv -O slgoagent.tar.gz \
  https://${SL_DOMAIN}/agents/slgoagent/${SL_AGENT_VERSION}/slgoagent-${SL_OS_ARCH}.tar.gz

tar -xzf slgoagent.tar.gz && rm -f slgoagent.tar.gz
echo "[SeaLights] Installed: $(./slgoagent -v 2>/dev/null | grep version)"

- name: Download SeaLights Go Agent (specific version)
  shell: bash
  env:
    SL_OS_ARCH: linux-amd64   # linux-amd64 | linux-arm64 | darwin-amd64 | darwin-arm64
    SL_DOMAIN: "<your-custom-domain>.sealights.co"   # Replace with your account domain
    SL_TOKEN: ${{ secrets.SL_TOKEN }}
    SL_AGENT_VERSION: ""   # Set to "latest", "vX.Y.Z" to pin, or leave empty to use API
  run: |
    if [ -z "${SL_AGENT_VERSION}" ]; then
      echo "[SeaLights] Resolving recommended version from dashboard..."
      SL_AGENT_VERSION=$(curl -sSf \
        -H "Authorization: Bearer ${SL_TOKEN}" \
        "https://${SL_DOMAIN}/api/v2/agents/slgoagent/recommended/version" \
        | grep -o '"version":"[^"]*"' | cut -d'"' -f4)
    fi

    echo "[SeaLights] Resolved version: ${SL_AGENT_VERSION}"
    wget -nv -O slgoagent.tar.gz \
      https://${SL_DOMAIN}/agents/slgoagent/${SL_AGENT_VERSION}/slgoagent-${SL_OS_ARCH}.tar.gz
    tar -xzf slgoagent.tar.gz && rm -f slgoagent.tar.gz
    echo "[SeaLights] Installed: $(./slgoagent -v 2>/dev/null | grep version)"

SL_OS_ARCH=darwin-arm64   # darwin-arm64 for Apple Silicon, darwin-amd64 for Intel
SL_DOMAIN="<your-custom-domain>.sealights.co"   # Replace with your account domain
SL_TOKEN=$(cat ./sltoken.txt)                    # Or inject via secret/env var
SL_AGENT_VERSION=""   # Set to "latest", "vX.Y.Z" to pin, or leave empty to use API

if [ -z "${SL_AGENT_VERSION}" ]; then
  echo "[SeaLights] Resolving recommended version from dashboard..."
  SL_AGENT_VERSION=$(curl -sSf \
    -H "Authorization: Bearer ${SL_TOKEN}" \
    "https://${SL_DOMAIN}/api/v2/agents/slgoagent/recommended/version" \
    | grep -o '"version":"[^"]*"' | cut -d'"' -f4)
fi

echo "[SeaLights] Resolved version: ${SL_AGENT_VERSION}"
curl -sSL -o slgoagent.tar.gz \
  https://${SL_DOMAIN}/agents/slgoagent/${SL_AGENT_VERSION}/slgoagent-${SL_OS_ARCH}.tar.gz

tar -xzf slgoagent.tar.gz && rm -f slgoagent.tar.gz
echo "[SeaLights] Installed: $(./slgoagent -v 2>/dev/null | grep version)"

PreviousGo Agent V2 NextGo Agent: How to use

Last updated 6 days ago

Was this helpful?