setup-oleander-cli

GitHub Action for installing oleander-cli on Ubuntu runners using Oleander's official APT repository.

This action currently supports Ubuntu only. The official Oleander installation path is via APT on Ubuntu, so the action validates the runner OS before installing.

Usage

Install the latest available oleander-cli version from the Oleander APT repository:

steps:
  - name: Setup oleander-cli
    uses: OleanderHQ/setup-oleander-cli@v1

Install an explicit version:

steps:
  - name: Setup oleander-cli
    uses: OleanderHQ/setup-oleander-cli@v1
    with:
      version: 0.7.0

Inputs

Name	Required	Default	Description
version	No	latest available	Exact oleander-cli APT package version to install, for example 0.7.0. If omitted, the action installs the latest version currently available in the Oleander APT repository.

Version Selection

When version is set, the action installs oleander-cli=<version> through APT and fails clearly if that exact version is not available.

When version is omitted, the action installs the latest version available from the Oleander APT repository at workflow run time.

The action ref and the CLI version are separate. For example, uses: OleanderHQ/setup-oleander-cli@v1 selects the action release, while with: version: 0.7.0 selects the oleander-cli package version to install.

What The Action Does

The action follows the documented Ubuntu APT installation flow:

1. Installs curl, ca-certificates, and gnupg
2. Installs the Oleander signing key at /usr/share/keyrings/oleander-archive-keyring.gpg
3. Writes /etc/apt/sources.list.d/oleander.sources
4. Runs apt-get update
5. Installs oleander-cli
6. Verifies that oleander is available and prints the installed version