CLI & SSH

Caster includes a full SSH CLI for managing your sites, deployments, and SSH keys from the terminal. Any command you can do in the web console, you can do over SSH.

Usage

ssh caster.zip <command> [args...]

Your SSH key must be registered with your account first.

Commands

Account

# Show your account info (email, user ID)
ssh caster.zip whoami

Sites

# List all your sites
ssh caster.zip sites list

# Create a new site (auto-generates a unique ID)
ssh caster.zip sites create

# Show site details (URL, active deployment, status)
ssh caster.zip sites info a3f9c2e8

# Set a custom subdomain name
ssh caster.zip sites rename a3f9c2e8 my-project

# Delete a site (removes DNS records, git repo, and containers)
ssh caster.zip sites delete a3f9c2e8

Site identifiers can be the short ID (e.g., a3f9c2e8) or the custom name if one is set.

Deployments

# List deployments for a site
ssh caster.zip deployments list a3f9c2e8

# Show details for a specific deployment
ssh caster.zip deployments info a3f9c2e8 42

# View build logs for a deployment
ssh caster.zip deployments logs a3f9c2e8 42

# Rollback to a previous deployment (reuses the old container image)
ssh caster.zip deployments rollback a3f9c2e8 42

SSH Keys

# List your registered SSH keys
ssh caster.zip keys list

# Add a new SSH key
ssh caster.zip keys add laptop ssh-ed25519 AAAA... you@laptop

# Remove an SSH key by ID
ssh caster.zip keys remove 3

Examples

Create a site and deploy with git:

# Create the site
ssh caster.zip sites create
# Output: Site a3f9c2e8 created. URL: https://a3f9c2e8.caster.zip

# Add the git remote and push
cd ~/my-project
git remote add caster git@git.caster.zip:a3f9c2e8.git
git push caster main

# Check deployment status
ssh caster.zip deployments list a3f9c2e8

Set a custom name:

ssh caster.zip sites rename a3f9c2e8 my-project
# Now accessible at both a3f9c2e8.caster.zip and my-project.caster.zip

Roll back a bad deploy:

# List deployments to find the last good one
ssh caster.zip deployments list a3f9c2e8

# Rollback to deployment #3
ssh caster.zip deployments rollback a3f9c2e8 3

Help

Run help to see all available commands:

ssh caster.zip help