---
title: "subako cloud"
description: "Subako Cloud self-service"
---

[CLI reference](/cli)

## `subako cloud`

Subako Cloud self-service

### Usage

```text
Usage: subako cloud <COMMAND>
```

### Subcommands

- [`subako cloud signup`](#subako-cloud-signup)
- [`subako cloud billing`](#subako-cloud-billing)

### Options

#### `--help`

Print help

- Short option: `-h`.

## `subako cloud signup`

Sign up and create an organization. Stores nothing: `login` against the Core server this prints is what mints a credential

### Usage

```text
Usage: subako cloud signup [OPTIONS] --org <ORG>
```

### Options

#### `--org <ORG>`

Handle for the new organization, as it appears in its URLs

- Required.

#### `--name <NAME>`

Display name for the new organization. Defaults to the handle


#### `--cloud <CLOUD>`

Base URL of the Subako Cloud Service API to sign up against

- Environment variable: `SUBAKO_CLOUD`.
- Default: `https://service.us.cloud.subako.ai`.

#### `--help`

Print help

- Short option: `-h`.

## `subako cloud billing`

Plan, subscription, credits, and the payment method

### Usage

```text
Usage: subako cloud billing <COMMAND>
```

### Subcommands

- [`subako cloud billing show`](#subako-cloud-billing-show)
- [`subako cloud billing subscribe`](#subako-cloud-billing-subscribe)
- [`subako cloud billing credits`](#subako-cloud-billing-credits)
- [`subako cloud billing portal`](#subako-cloud-billing-portal)

### Options

#### `--help`

Print help

- Short option: `-h`.

## `subako cloud billing show`

Print the plan, subscription, and payment method

### Usage

```text
Usage: subako cloud billing show [OPTIONS]
```

### Options

#### `--cloud <CLOUD>`

Base URL of the Subako Cloud Service API the organization bills through

- Environment variable: `SUBAKO_CLOUD`.
- Default: `https://service.us.cloud.subako.ai`.

#### `--profile <PROFILE>`

Credential profile to act as. Defaults to the current one


#### `--credentials-file <CREDENTIALS_FILE>`

Path to the credentials file. Defaults to SUBAKO_CREDENTIALS_FILE, then ~/.config/subako/credentials.json.


#### `--help`

Print help

- Short option: `-h`.

## `subako cloud billing subscribe`

Subscribe to a plan, or change to it when the organization already subscribes. Opens Checkout for a first subscription and the billing portal's plan-change confirmation otherwise

### Usage

```text
Usage: subako cloud billing subscribe [OPTIONS] --plan <PLAN>
```

### Options

#### `--plan <PLAN>`

Plan slug to subscribe to, as the deployment's catalog spells it

- Required.

#### `--cloud <CLOUD>`

Base URL of the Subako Cloud Service API the organization bills through

- Environment variable: `SUBAKO_CLOUD`.
- Default: `https://service.us.cloud.subako.ai`.

#### `--profile <PROFILE>`

Credential profile to act as. Defaults to the current one


#### `--credentials-file <CREDENTIALS_FILE>`

Path to the credentials file. Defaults to SUBAKO_CREDENTIALS_FILE, then ~/.config/subako/credentials.json.


#### `--help`

Print help

- Short option: `-h`.

## `subako cloud billing credits`

Open a Checkout session that buys credits

### Usage

```text
Usage: subako cloud billing credits [OPTIONS] --amount <AMOUNT>
```

### Options

#### `--amount <AMOUNT>`

How many SC to buy. The Service API owns the bounds

- Required.

#### `--cloud <CLOUD>`

Base URL of the Subako Cloud Service API the organization bills through

- Environment variable: `SUBAKO_CLOUD`.
- Default: `https://service.us.cloud.subako.ai`.

#### `--profile <PROFILE>`

Credential profile to act as. Defaults to the current one


#### `--credentials-file <CREDENTIALS_FILE>`

Path to the credentials file. Defaults to SUBAKO_CREDENTIALS_FILE, then ~/.config/subako/credentials.json.


#### `--help`

Print help

- Short option: `-h`.

## `subako cloud billing portal`

Open the Stripe customer portal, where a card is changed, a plan is changed, and a subscription cancelled

### Usage

```text
Usage: subako cloud billing portal [OPTIONS]
```

### Options

#### `--cloud <CLOUD>`

Base URL of the Subako Cloud Service API the organization bills through

- Environment variable: `SUBAKO_CLOUD`.
- Default: `https://service.us.cloud.subako.ai`.

#### `--profile <PROFILE>`

Credential profile to act as. Defaults to the current one


#### `--credentials-file <CREDENTIALS_FILE>`

Path to the credentials file. Defaults to SUBAKO_CREDENTIALS_FILE, then ~/.config/subako/credentials.json.


#### `--help`

Print help

- Short option: `-h`.
