Skip to main content

Using the CLI

Installation

The fluidctl CLI is available for install as a Golang binary. First, install Go and then run the following command:

go install github.com/fluidstackio/fluidctl/cmd/fluidctl@latest

Select a Region

The -U argument can be used to select a region. The url for each region follows the pattern https://{{ name }}.atlas.fluidstack.io.

Authentication

By default, fluidctl will authenticate using the OAuth authorization flow. The OAuth Access Token will be cached at ~/.fluidstack/token.

fluidctl projects list

Provide your OAuth Client ID and Client Secret to authenticate with the client credentials flow.

fluidctl projects list --client-id=$CLIENT_ID --client-secret=$CLIENT_SECRET 

Provide an OAuth Access Token to authenticate with an access token.

fluidctl projects list -T $TOKEN