Getting Started

Prerequisites

• SeaLights Account: Active SeaLights account with access credentials

• Authentication Token: Valid SeaLights Agent token

• 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.22+)

• 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 latest SeaLights Go Agent file can be downloaded from:

• https://${DOMAIN}/slgoagent/latest/slgoagent-${OS_ARCH}.tar.gz

where OS_ARCH is one of: darwin-amd64, darwin-arm64, linux-amd64, linux-arm64, and DOMAIN can be our generic endpoint (agents.sealights.co) or your specific account domain endpoint (<your_custom_domain>.sealights.co/agents).

For your convenience, this table contains all of the direct links for downloading 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

Sample Scripts for Downloading the Go Agent

Downloading and extracting the latest version:

SL_OS_ARCH=linux-amd64
# Download and extract Sealights Go agent
echo "[Sealights] Downloading Sealights Golang Agent..."
wget -nv -O slgoagent.tar.gz \
    https://agents.sealights.co/slgoagent/latest/slgoagent-${SL_OS_ARCH}.tar.gz \
    && tar -xvf slgoagent.tar.gz \
    && rm slgoagent.tar.gz
./slgoagent -v 2> /dev/null | grep version

Downloading a specific version

Replace “latest” with the desired version when downloading a specific version. Please note the format of the specific version URL that includes the v prefix.

Example script 1 — Downloading a specific version for Linux x86-64:

# One of: darwin-amd64, darwin-arm64, linux-amd64, linux-arm64
SL_OS_ARCH=linux-amd64
# Specific Version to download
SL_GO_AGENT_VERSION=v2.0.213

echo "[Sealights] Downloading Sealights Golang Agent..."
wget -nv -O slgoagent.tar.gz https://agents.sealights.co/slgoagent/${SL_GO_AGENT_VERSION}/slgoagent-${SL_OS_ARCH}.tar.gz
# Unpack the agent and clean up the tar
tar -xvf slgoagent.tar.gz
rm slgoagent.tar.gz
# Print the version
./slgoagent -v 2> /dev/null | grep version

Example script 2 — Downloading a specific version MacOS (Silicon)

# For Mac with Apple Silicon (M1/M2/M3... chips)
export SL_OS_ARCH=darwin-arm64
export SL_GO_AGENT_VERSION=v2.0.208

echo "[Sealights] Downloading Sealights Golang Agent..."

# Use curl instead of wget
curl -L -o slgoagent.tar.gz "https://agents.sealights.co/slgoagent/${SL_GO_AGENT_VERSION}/slgoagent-${SL_OS_ARCH}.tar.gz"

# Unpack the agent and clean up the tarball
tar -xvf slgoagent.tar.gz
rm slgoagent.tar.gz

# Print the agent version
./slgoagent -v 2> /dev/null | grep version