Developer Platform

Command Line Interface

Manage StrataGateway infrastructure directly from your terminal using a fast, scriptable developer workflow.

Coming Soon

Development Preview

The StrataGateway CLI is currently planned and not yet publicly available. Command names, flags, configuration files, authentication workflows, output formats, and installation methods may change before release.

Jump to article

Overview

The StrataGateway CLI is intended to provide a terminal-native interface over the StrataGateway API, enabling fast infrastructure workflows directly from the command line.

Fast infrastructure workflows
Scriptable commands
Predictable resource naming
JSON output for automation
Human-readable terminal output
API token authentication
Parity with core REST API operations

The StrataGateway CLI is currently planned and not yet publicly available. Command names, flags, configuration files, authentication workflows, output formats, and installation methods may change before release.

Planned installation

The CLI is not yet available for download. The examples below illustrate the planned installation approach.

Planned

Illustrative installation example

Install script (illustrative)

Install script (illustrative)Bash
curl -fsSL https://example.invalid/install-strata.sh | sh

Important: Do not use stratagateway.com as a real install URL unless such an installer actually exists.

Planned package-manager possibilities

Homebrew
Package repositories
Direct binary download

The above are text-only descriptions of planned distribution methods. No working download links exist yet.

Authentication

The CLI is planned to authenticate using API tokens. You can log in interactively or set an environment variable.

Interactive login

Interactive loginBash
strata auth login

Alternative: set the token via environment variable.

Environment variable (bash/zsh)

Environment variable (bash/zsh)Bash
export STRATA_API_TOKEN="your_token_here"

Environment variable (PowerShell)

Environment variable (PowerShell)PowerShell
$env:STRATA_API_TOKEN="your_token_here"

Command syntax is illustrative and may change.

See Authentication for token management details.

Configuration

The CLI is planned to support a configuration file for default settings.

Planned config options

Planned
Default organization
Default region
Output format
API endpoint
Authentication profile

Illustrative configuration file at ~/.config/strata/config.yaml:

Illustrative configuration

Illustrative configurationYAML
organization: org_example
region: fra-1
output: table

This file format is not finalized and may change.

Core commands

Planned top-level command structure:

Planned

Planned CLI command structure

Command groups

Command groupstext
strata version
strata help
strata auth
strata config
strata instance
strata network
strata firewall
strata ssh-key

Compute commands

Illustrative examples for instance management:

List instances

List

ListBash
strata instance list

Create instance

Create

CreateBash
strata instance create \
  --name web-prod-01 \
  --region fra-1 \
  --plan compute-standard \
  --image ubuntu-24.04-lts

Inspect instance

Get

GetBash
strata instance get inst_7a91c2

Reboot instance

Reboot

RebootBash
strata instance reboot inst_7a91c2

Delete instance

Delete

DeleteBash
strata instance delete inst_7a91c2

Every command above is preview syntax. The CLI does not currently exist.

Network commands

Illustrative network management examples:

List networks

List

ListBash
strata network list

Create network

Create

CreateBash
strata network create \
  --name production-private \
  --region fra-1 \
  --cidr 10.10.0.0/24

Inspect network

Get

GetBash
strata network get net_52a8f1

Illustrative CLI syntax.

See Networking for the network resource model.

Firewall commands

Illustrative firewall management examples:

List firewalls

List

ListBash
strata firewall list

Create firewall

Create

CreateBash
strata firewall create --name web-production

Inspect firewall

Get

GetBash
strata firewall get fw_82c9a1

Rule management syntax is still under design.

See Firewalls for the firewall policy model.

SSH key commands

Illustrative SSH key management examples:

List SSH keys

List

ListBash
strata ssh-key list

Add SSH key

Add

AddBash
strata ssh-key add \
  --name "Personal Laptop" \
  --file ~/.ssh/id_ed25519.pub

Delete SSH key

Delete

DeleteBash
strata ssh-key delete key_8f3a9b1c

The CLI should only upload public SSH key material. Private keys must remain on the user's trusted device.

See SSH Keys for the key management model.

Output formats

The CLI is planned to support multiple output modes:

Table

Human-readable terminal output.

JSON

Machine-readable automation output.

Illustrative usage:

JSON output

JSON outputBash
strata instance list --output json

Illustrative output

JSON response

JSON responseJSON
{
  "data": [
    {
      "id": "inst_7a91c2",
      "name": "web-prod-01",
      "status": "running"
    }
  ]
}

Illustrative output.

Scripting and automation

The CLI is intended for use in CI/CD pipelines, shell scripts, infrastructure automation, and developer workflows.

Illustrative automation workflow.

Capture instance ID in variable

Capture instance ID in variableBash
INSTANCE_ID=$(strata instance create \
  --name ci-worker \
  --region fra-1 \
  --output json)

The actual output schema is not finalized. The above is illustrative only.

Exit codes

The CLI is planned to follow standard conventions:

CodeMeaning
0Command succeeded
Non-zeroCommand failed

Detailed exit code semantics will be documented before public release.

Planned

Planned

Shell completion

Planned support for shell completion:

Bash
Zsh
Fish
PowerShell

Shell completion is not yet implemented.

Planned

Planned

CLI and REST API

The CLI is intended to act as a developer-friendly interface over the same core StrataGateway API used by SDKs and infrastructure tooling.

Conceptual flow

Conceptual flowtext
Developer
→ StrataGateway CLI
→ REST API
→ Control Plane

See REST API for the underlying API resource model.

Was this page helpful?