CLI

CLI Reference

Command-line interface for tasmanian.cloud

tasmanian-cloud CLI

The tasmanian-cloud CLI provides command-line access to manage your infrastructure on tasmanian.cloud.

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

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 (RustFS)

# 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 (for external access)
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

VariableDescription
TC_API_KEYAPI key for authentication
TC_REGIONDefault region (tas-1)
TC_OUTPUTDefault output format

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