Command Reference

# List your workspaces
smll workspaces list

# Set workspace (and optionally VPC) context
smll context set my-workspace
smll context set my-workspace production-vpc

# Show current context
smll context show

# List all workspaces you're a member of
smll workspaces list

smll vpcs list

smll vpcs show production

smll vpcs create --name production --region eu-central-1

smll vpcs update production --rename staging

smll vpcs delete production --force

smll vpcs s3-credentials production

smll services list

smll services show my-app

# Basic web service
smll services create --name my-app --image registry.smll.io/vpc-abc/myapp:latest --port 3000

# Worker (no ingress)
smll services create --name worker --image myapp:latest --type worker

# Cron job
smll services create --name nightly-sync --image myapp:latest --type cron --cron "0 0 * * *"

# With all options
smll services create --name my-app --image myapp:latest \
  --port 8080 --plan smll.small --type web --mode on_demand \
  --min-replicas 0 --max-replicas 3 --health-check /health \
  --disk-size 5 --disk-mount /data

# Rename
smll services update my-app --rename new-name

# Change plan
smll services update my-app --plan smll.medium

# Scale replicas
smll services update my-app --min-replicas 2 --max-replicas 5

# Switch to scale-to-zero with idle timeout
smll services update my-app --mode on_demand --idle-timeout 300

# Change port and health check
smll services update my-app --port 8080 --health-check /healthz

# Add persistent disk
smll services update my-app --disk-size 10 --disk-mount /data

smll services logs my-app
smll services logs my-app --follow         # stream logs
smll services logs my-app --tail 50        # last 50 lines

smll services restart my-app

smll services deployments my-app

smll services rollback my-app --deployment abc12345

# List env vars
smll services env list my-app

# Set env vars (multiple at once)
smll services env set my-app DATABASE_URL=postgresql://... REDIS_URL=redis://...

# Set using flags
smll services env set --name my-app --var DATABASE_URL=postgresql://... --var API_KEY=secret

# Link a secret as an env var
smll services env set my-app --from-secret DB_PASS=my-db-secret/password

# Mix plain values and secret references
smll services env set my-app PORT=3000 --from-secret DB_URL=db-creds/url

# Delete env vars
smll services env delete my-app DATABASE_URL REDIS_URL

smll services uptime my-app

# List backups
smll services backups list my-app

# Create a backup
smll services backups create my-app

# Restore from a backup
smll services backups restore my-app --backup abc12345

# View backup schedule
smll services backups schedule my-app

# Configure backup schedule
smll services backups schedule my-app --enabled on --frequency daily --retention 7

smll services delete my-app --force

# Deploy a container image
smll deploy --name my-app --image registry.smll.io/vpc-abc/myapp:v2.0.0

# Deploy from source (current directory)
smll deploy --name my-app

# Deploy from a specific directory
smll deploy --name my-app --dir ./backend

smll db list

smll db show mydb
smll db show --name mydb

# PostgreSQL (default)
smll db create --name mydb

# MySQL
smll db create --name mydb --engine mysql

# With all options
smll db create --name mydb --engine postgresql --instance-type smll.small \
  --storage-gb 10 --version 17 --replicas 1 --external-access

smll db connect mydb
smll db connect --name mydb

Engine:       PostgreSQL
Host:         db-mydb-rw.vpc-abc12345.svc
Port:         5432
Database:     app
Username:     app
Password:     xxxxxxxx

Internal URL: postgresql://app:xxxxxxxx@db-mydb-rw.vpc-abc12345.svc:5432/app

── External ─────────────────────────────────
Host:         abc12345.eu-central-1.database.smllapp.com
Port:         5432
URL:          postgresql://app:xxxxxxxx@abc12345.eu-central-1.database.smllapp.com:5432/abc12345

# Rename
smll db update mydb --rename new-name

# Change instance type
smll db update mydb --instance-type smll.medium

# Enable external access
smll db update mydb --external-access on

# Disable external access
smll db update mydb --external-access off

# Multiple changes at once
smll db update mydb --instance-type smll.large --external-access on

# Add 2 read replicas
smll db replicas mydb --count 2

# Remove all replicas
smll db replicas mydb --count 0

smll db fork mydb --target mydb-staging

smll db query mydb "SELECT * FROM users LIMIT 10"
smll db query --name mydb "SELECT count(*) FROM orders"

smll db schema mydb
smll db schema --name mydb --json

# Show top slow queries (sorted by average execution time)
smll db slow-queries mydb

# Sort by total time
smll db slow-queries mydb --sort total_exec_time

# Limit results
smll db slow-queries mydb --limit 10

# Reset statistics
smll db slow-queries reset mydb

smll db delete mydb --force

smll db backups list mydb

smll db backups create mydb

# PostgreSQL: point-in-time recovery
smll db backups restore mydb --target mydb-restored \
  --target-time "2026-03-27T10:00:00Z"

# MySQL: restore from a specific backup
smll db backups restore mydb --target mydb-restored \
  --backup "mydb-backup-20260327"

smll db backups delete mydb --backup "mydb-backup-20260327"

# Set a daily backup at 2am UTC
smll db backups schedule mydb --cron "0 2 * * *"

# Disable scheduled backups
smll db backups schedule mydb --enabled off

# Set retention to 14 days
smll db backups schedule mydb --retention-days 14

# Multiple changes
smll db backups schedule mydb --cron "0 2 * * *" --retention-days 30 --enabled on

# View recent logs for the VPC
smll logs

# Follow logs in real time
smll logs --follow

# Filter by service
smll logs --service my-api

# Filter by severity
smll logs --severity error

# Search logs by keyword
smll logs --search "connection refused"

# Combine filters
smll logs --service my-api --severity error --follow

# Limit output
smll logs --tail 100

# Custom time range
smll logs --since 2h
smll logs --since 2026-03-01T00:00:00Z

smll secrets list

smll secrets show DATABASE_URL

# Single key-value pair
smll secrets set db-creds DATABASE_URL=postgresql://...

# Multiple key-value pairs
smll secrets set db-creds DATABASE_URL=postgresql://... PASSWORD=secret123

# Using flags
smll secrets set --name api-keys --kv STRIPE_KEY=sk_live_... --kv SENDGRID_KEY=SG...

smll secrets delete DATABASE_URL --force

# List all buckets
smll storage buckets list

# Show bucket details (size, object count, static hosting, credentials)
smll storage buckets show my-bucket

# Create a private bucket
smll storage buckets create --name my-bucket

# Create a public bucket
smll storage buckets create --name assets --public

# Update bucket visibility
smll storage buckets update --name my-bucket --visibility public

# Enable static hosting
smll storage buckets update --name my-bucket --static-hosting \
  --index-document index.html --error-document 404.html

# Delete a bucket (requires --force)
smll storage buckets delete --name my-bucket --force

# List files in a bucket
smll storage ls --bucket my-bucket
smll storage ls --bucket my-bucket --prefix images/

# Upload a file
smll storage upload --bucket my-bucket --file ./backup.sql

# Upload with a custom key
smll storage upload --bucket my-bucket --file ./photo.jpg --key images/photo.jpg

# Upload an entire directory
smll storage upload --bucket my-bucket --dir ./dist --prefix assets/

# Download a file
smll storage download --bucket my-bucket --key backup.sql --output ./backup.sql

# Delete a file
smll storage rm --bucket my-bucket --key backup.sql

# Sync a local directory to a bucket
smll storage sync --bucket my-bucket --dir ./build
smll storage sync --bucket my-bucket --dir ./build --prefix static/ --delete

smll cache list

smll cache show my-cache

# Basic cache
smll cache create --name my-cache

# With all options
smll cache create --name my-cache --instance-type smll.small --version 7.4 \
  --replicas 2 --persistence --external-access --maxmemory-policy allkeys-lru

smll cache info my-cache

Engine:       Redis
Host:         cache-my-cache.vpc-abc12345.svc
Port:         6379
Password:     xxxxxxxx

Internal URL: redis://:xxxxxxxx@cache-my-cache.vpc-abc12345.svc:6379

── External ─────────────────────────────────
Host:         abc12345.eu-central-1.cache.smllapp.com
Port:         6379
URL:          rediss://:xxxxxxxx@abc12345.eu-central-1.cache.smllapp.com:6379

# Rename
smll cache update my-cache --rename new-name

# Resize
smll cache update my-cache --instance-type smll.medium

# Enable external access
smll cache update my-cache --external-access on

# Change replicas and eviction policy
smll cache update my-cache --replicas 3 --maxmemory-policy allkeys-lfu

smll cache delete my-cache --force

# List rules
smll cache ip-allowlist list my-cache

# Add a rule
smll cache ip-allowlist add my-cache --cidr 203.0.113.0/24 --description "Office"

# Delete a rule
smll cache ip-allowlist delete my-cache --rule-id abc12345 --force

smll queue list

smll queue show my-queue

# Basic queue (starter plan)
smll queue create --name my-queue

# With options
smll queue create --name my-queue --plan standard --external-access

smll queue info my-queue

Engine:          NATS
Host:            queue-my-queue.vpc-abc12345.svc
Port:            4222
Monitoring port: 8222
Token:           xxxxxxxx

Internal URL:    nats://xxxxxxxx@queue-my-queue.vpc-abc12345.svc:4222

── External ─────────────────────────────────
Host:            abc12345.eu-central-1.queue.smllapp.com
Port:            4222
URL:             tls://xxxxxxxx@abc12345.eu-central-1.queue.smllapp.com:4222

# Rename
smll queue update my-queue --rename new-name

# Upgrade plan
smll queue update my-queue --plan pro

# Enable external access
smll queue update my-queue --external-access on

smll queue delete my-queue --force

smll domains list my-app
smll domains list --service my-app

smll domains add --domain app.example.com --service my-app

smll domains verify --domain app.example.com --service my-app

smll domains delete --domain app.example.com --service my-app --force

smll billing balance

# Current month
smll billing usage

# Specific month
smll billing usage --period 2026-03

# Last 30 days (default)
smll billing daily

# Last 7 days
smll billing daily --days 7

smll billing estimate --resource-type smll.small

# With custom hours
smll billing estimate --resource-type smll.medium --quantity 2 --hours 360

smll billing projection

smll billing invoices

# List alerts
smll billing alerts list

# Create an alert at £5.00
smll billing alerts create --threshold 5.00

# Delete an alert
smll billing alerts delete <alert-id> --force

# Show current config
smll billing config show

# Set spend cap action
smll billing config set --spend-cap-action scale_down

# Set spend cap amount
smll billing config set --spend-cap 10.00

smll status

smll registry list

smll registry credentials

smll registry artifacts my-app

smll registry vulnerabilities --repo my-app --ref latest

# Delete entire repository
smll registry delete --repo my-app --force

# Delete a specific tag
smll registry delete --repo my-app --ref v1.0.0 --force

smll quotas

smll alerting list

smll alerting create --name "High CPU" --resource-type service \
  --metric cpu_percent --condition gt --threshold 80 --channel email

smll alerting create --name "DB connections" --resource-type database \
  --resource-id abc123 --metric connections --condition gt \
  --threshold 90 --duration 5m --channel webhook

smll alerting update --id abc123 --threshold 90 --enabled off

smll alerting delete --id abc123 --force

smll alerting history
smll alerting history --limit 50

smll webhooks list

smll webhooks create --url https://example.com/hook \
  --event service.deployed --event database.created

smll webhooks update --id abc123 --url https://new-url.com/hook --enabled off

smll webhooks delete --id abc123 --force

smll webhooks test --id abc123

smll activity list
smll activity list --limit 50

smll activity summary

smll audit-logs list
smll audit-logs list --action database.created --user admin@example.com --limit 100

smll audit-logs export > audit.json

smll support list

smll support show abc12345

smll support create --subject "Database connection issue" \
  --body "My database is not accepting connections since 10am UTC" \
  --category technical --priority high

smll support reply abc12345 --body "I've attached the logs, can you check?"

smll api-keys list

smll api-keys create --name "CI/CD"
smll api-keys create --name "Deploy Bot" --expires 90d

smll api-keys revoke --id abc123 --force

smll services list --json
smll db list --json | jq '.[].name'

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

# Zsh
smll completion zsh > "${fpath[1]}/_smll"

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