Skip to content

Installing the Galasa CLI

Download and install the Galasa CLI tool from the Galasa Releases page in GitHub.

Prerequisites

Before installing, ensure you have the required software installed. See the Prerequisites documentation for details.

Available downloads

The following versions of the Galasa CLI are available for different operating systems and architectures:

Operating system Architecture Download
MacOSX x86_64 galasactl-darwin-x86_64
MacOSX arm64 galasactl-darwin-arm64
Linux x86_64 galasactl-linux-x86_64
Linux arm64 arm64 galasactl-linux-arm64
zLinux s390x galasactl-linux-s390x
Windows x86_64 galasactl-windows-x86_64.exe

Installation

Choose your installation method:

  1. Connect Homebrew to the Galasa tap: 

    brew tap galasa-dev/tap

  2. Install the latest version: 

    brew install galasactl

Or install a specific version (e.g., 0.48.0): 

brew install galasactl@0.48.0

  1. Check available versions: 

    brew tap-info galasa-dev/tap --json
    Look in the "cask_tokens" section of the output.

  2. Remove quarantine attribute: 

    xattr -dr com.apple.quarantine galasactl

  1. Find your machine architecture: 

    uname -m

  2. Download the appropriate binary from the Galasa Releases page and rename it to galasactl

  3. Add the Galasa CLI to your PATH. For example, if you downloaded galasactl to ~/tools, add this line to your shell's initialization file (~/.bashrc or ~/.zshrc): 

    export PATH=$PATH:$HOME/tools

  4. Set execute permission: 

    chmod +x galasactl

  5. macOS only: Remove quarantine attribute: 

    xattr -dr com.apple.quarantine galasactl

  1. Download the Windows executable from the Galasa Releases page and rename it to galasactl.exe

  2. Add the directory containing galasactl.exe to your PATH environment variable through System Properties → Environment Variables

  3. Open a command prompt and verify: 

    galasactl --version

You can now run the Galasa CLI from any directory without specifying the full path.

Upgrading the Galasa CLI

Update to the latest version: 

brew update
brew upgrade galasactl

The brew update command refreshes Homebrew's catalog, and brew upgrade galasactl updates the CLI.

Download the latest binary from the Galasa Releases page and replace your existing galasactl binary.

Download the latest executable from the Galasa Releases page and replace your existing galasactl.exe file.

Next steps

  1. Learn about available commands in the Galasa CLI commands documentation
  2. Initialize your local environment to set up the necessary file structures