cli

Exoscale CLI

Manage your Exoscale infrastructure easily from the command-line with exo.

Installation

Using pre-built releases (recommended)

You can find pre-built releases of the CLI here.

From sources

To build exo from sources, a Go compiler >= 1.16 is required.

$ git clone https://github.com/exoscale/cli
$ cd cli
$ git submodule update --init --recursive go.mk
$ make build

Upon successful compilation, the resulting exo binary is stored in the bin/ directory.

Using the scoop package manager on Windows

If you haven't installed scoop already, follow the instructions at scoop.sh before installing exo with:

scoop bucket add exoscale-cli https://github.com/exoscale/cli
scoop install exoscale-cli

To update exo to the latest version:

scoop update
scoop update exoscale-cli

Configuration

Running the exo config command will guide you through the initial configuration.

You can create and find API credentials in the IAM section of the Exoscale Console.

The configuration file and all assets created during exo operations will be saved in the following location:

The configuration parameters are then saved in a exoscale.toml file with the following minimum format:

defaultaccount = "account_name"

[[accounts]]
  account = "account_name"
  endpoint = "https://api.exoscale.com/v1"
  key = "API_KEY"
  name = "account_name"
  secret = "API_SECRET"

The current configuration and configuration file path can be shown with exo config show.

Usage

The exo CLI contains documentation for all of its commands, you can explore them by running exo help. Additional information and tutorials are available on Exoscale's community website.

Integrations

Fig

When using Fig you can run this command to output Fig completion spec:

exo integrations generate-fig-spec

External contributions

• setup-exoscale GitHub action