Skip to main content
Version: latest

Agent Mode

The following sections provide links to download the agent mode installation scripts depending on your environment.

Agent mode is a deployment mode that enables Palette to manage your own host and operating system. Unlike other deployment modes, agent mode gives you more flexibility in managing your infrastructure and OS. Refer to the agent mode documentation for guidance on how to set up agent mode on your hosts.

Central Management Mode

This version of agent mode requires internet access on the host to connect to a Palette instance.

Latest

Use the following command to download the latest version of the Palette agent installation script.

curl --location --output ./palette-agent-install.sh https://github.com/spectrocloud/agent-mode/releases/latest/download/palette-agent-install.sh

Versioned

If you have a dedicated or on-prem instance of Palette, you need to identify the correct agent version and then download the corresponding version of the agent installation script.

  1. Use the following command to identify the agent version for your Palette instance. Replace <palette-endpoint> with your Palette endpoint and <api-key> with your Palette API key.

    curl --location --request GET 'https://<palette-endpoint>/v1/services/stylus/version' --header 'Content-Type: application/json' --header 'Apikey: <api-key>'  | jq --raw-output '.spec.latestVersion.content | match("version: ([^\n]+)").captures[0].string'
    Example output
    4.5.0
  2. Use the following command to download the version of the Palette agent for your dedicated or on-prem instance. Replace <stylus-version> with your output from the previous step.

    curl --location --output ./palette-agent-install.sh https://github.com/spectrocloud/agent-mode/releases/download/v<stylus-version>/palette-agent-install.sh

Local Management Mode

This version of agent mode is designed for environments without a connection to Palette and may also have limited access to the internet.

Download the agent installation package and save it as a TAR file.

  • Replace <architecture> with the architecture of your CPU. If you have ARM64, use arm64. If you have AMD64 or x86_64, use amd64.
  • Replace <version> with the desired version number. Refer to agent mode releases for all the available releases.
curl -L https://github.com/spectrocloud/agent-mode/releases/download/<version>/agent-mode-linux-<architecture>.tar --output agent-mode-linux-<architecture>.tar