Last modified January 6, 2021
gsctl CLI reference
gsctl is the command line utility to manage your Giant Swarm clusters.
Follow the links below for a detailed documentation, where available. You can also always use
gsctl <command> --help.
For finding out which version of
gsctl you currently have installed, and other useful information about the build, use the
gsctl --version command.
Installing and updating
gsctl comes as a self-contained binary for Mac, Linux, and Windows. Below you find installation instructions for different platforms. If you want to build
gsctl from source, find everything you need in its GitHub repository.
gsctl version is 0.27.0. Find details in the release notes.
Homebrew provides the most convenient way to install
gsctl and keep it up to date. To install, use this command:
brew tap giantswarm/giantswarm brew install gsctl
brew upgrade gsctl
To install without homebrew, download the latest release from GitHub, unpack the binary and move it to a location covered by your `PATH` environment variable.
gsctl can be installed using an AUR helper, such as
yay -S gsctl-bin
Download the latest release from GitHub, unpack the binary and move it to a location covered by your `PATH` environment variable.
scoop enables convenient installs and updates for Windows PowerShell users. Before you can install
gsctl for the first time, execute this:
scoop bucket add giantswarm https://github.com/giantswarm/scoop-bucket.git
scoop install gsctl
scoop update gsctl
To install without scoop, download the latest release from GitHub, unpack the binary and move it to a location covered by your `PATH` environment variable.
gsctl keeps its own settings under
$HOME/.config/gsctl/. There is a configuration file called
config.yaml. Key pairs are stored in the
The following environment variables can be used to affect some behavior:
GSCTL_ENDPOINT: This can be used to specify an API endpoint URL.
GSCTL_AUTH_TOKEN: This can be used to specify an authentication token.
GSCTL_CAFILE: If your Giant Swarm API endpoint uses a certificate signed by an authority not known to your operating system, this variable can be set to the path of a custom CA (certification authority) bundle. A CA bundle is a text file containing one or more CA certificates in PEM format.
GSCTL_CAPATH: Similar to
GSCTL_CAPATHis expected to point to a directory containing one or more PEM files.
GSCTL_DISABLE_COLORS: When this variable is set to any non-empty string, all terminal output will be monochrome.
GSCTL_DISABLE_CMDLINE_TRACKING: When this variable is set to any non-empty string, command lines won’t be submitted to the API. Otherwise, command lines are submitted to learn about the tool’s usage and find ways to improve.
NO_PROXYcan be used to define proxy server usage as detailed in the Go net/http ProxyFromEnvironment docs.
In addition, global command-line options are available.
Known bugs and limitations
Check our issues with label
You’ll find info on changes in the release description.
We welcome your feedback on
gsctl. If you feel like sharing openly, use the GitHub repository and create an issue, so other users can participate. Otherwise, please use the common Giant Swarm support channels.