CLI Reference

The tasmanian-cloud CLI calls the REST API. It provides a command-line client for the same resources, runs, events, and outputs used by the portal and SDKs.

Installation

curl -fsSL https://get.tasmanian.cloud/cli | sh

iwr -useb https://get.tasmanian.cloud/cli.ps1 | iex

brew install tasmanian-cloud/tap/tc

Authentication

# Login via browser
tc auth login

# Or use API key directly
tc auth login --api-key YOUR_API_KEY

# Verify authentication
tc auth whoami

Configuration

# Set default region
tc config set region tas-1

# View current config
tc config list

Commands

VPS Management

List your VPS instances:

tc vps list

Create a new VPS:

tc vps create --name my-server --size standard-2vcpu-4gb

Get VPS details:

tc vps get my-server

SSH into a VPS:

tc vps ssh my-server

Delete a VPS:

tc vps delete my-server

Templates (Self-Hosted Apps)

List available templates:

tc templates list

Deploy a template:

tc templates deploy postgres --name my-db

View deployed apps:

tc templates status

Remove a deployed app:

tc templates remove my-db

Saga runs

Start a system definition that includes compute, Compose, Ansible, or Terraform/OpenTofu work:

tc saga validate ./saga.yaml
tc saga plan ./saga.yaml
tc saga apply ./saga.yaml
tc saga status --run RUN_ID

The run ID links the CLI output to the portal, API events, and webhook notifications.

Kubernetes

List clusters:

tc k8s list

Create a cluster:

tc k8s create --name my-cluster --nodes 3

Get kubeconfig:

tc k8s kubeconfig my-cluster > ~/.kube/config

Delete cluster:

tc k8s delete my-cluster

Storage

List buckets:

tc storage buckets

Create a bucket:

tc storage create-bucket my-bucket

Generate S3 credentials:

tc storage credentials create --bucket my-bucket

List objects:

tc storage ls s3://my-bucket/

Networking

List private networks:

tc network list

Create a private network:

tc network create --name my-network --cidr 10.0.0.0/24

Add VPS to network:

tc network attach my-network --vps my-server

Get VPN config:

tc network vpn-config my-network

Output Formats

JSON output:

tc vps list --output json

Table output (default):

tc vps list --output table

YAML output:

tc vps list --output yaml

Quiet mode (IDs only):

tc vps list --quiet

Environment Variables

Shell Completion

# Bash
tc completion bash > /etc/bash_completion.d/tc

# Zsh
tc completion zsh > "${fpath[1]}/_tc"

# Fish
tc completion fish > ~/.config/fish/completions/tc.fish

Troubleshooting

Debug Mode

# Enable verbose logging
tc --debug vps list

# Check API connectivity
tc debug connectivity

Common Issues

Authentication failed

# Re-authenticate
tc auth logout
tc auth login

Region not available

# List available regions
tc regions list