CLI & SSH

Burrito 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 bntso.com <command> [args...]

Your SSH key must be registered with your account first.

Commands

Account

# Show your account info (username, email, user ID)
ssh bntso.com whoami

Sites

# List all your sites
ssh bntso.com sites list

# Create a new site
ssh bntso.com sites create myapp

# Show site details (environments, active deployments, URLs)
ssh bntso.com sites info myapp

# Delete a site (removes DNS records, git repo, and containers)
ssh bntso.com sites delete myapp

Deployments

# List deployments for a site
ssh bntso.com deployments list myapp

# Show details for a specific deployment
ssh bntso.com deployments info myapp 42

# View build logs for a deployment
ssh bntso.com deployments logs myapp 42

# Rollback to a previous deployment (reuses the old container image)
ssh bntso.com deployments rollback myapp 42

# Promote test environment to production
ssh bntso.com deployments promote myapp

SSH Keys

# List your registered SSH keys
ssh bntso.com keys list

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

# Remove an SSH key by ID
ssh bntso.com keys remove 3

Examples

Create a site and deploy in one workflow:

# Create the site
ssh bntso.com sites create myapp

# Add the git remote and push
cd ~/my-project
git remote add burrito git@bntso.com:myapp.git
git push burrito main

# Check deployment status
ssh bntso.com deployments list myapp

# View build logs
ssh bntso.com deployments logs myapp 1

Promote a tested change to production:

# Push to the test branch
git push burrito test

# Verify it works at test.myapp.bntso.com, then promote
ssh bntso.com deployments promote myapp

Roll back a bad deploy:

# List deployments to find the last good one
ssh bntso.com deployments list myapp

# Rollback to deployment #3
ssh bntso.com deployments rollback myapp 3

Help

Run help to see all available commands:

ssh bntso.com help