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:

OS	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.

Bash

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

GitHub Actions

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

macOS (zsh)

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

Bash

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

GitHub Actions

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

macOS (zsh)

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