CLI Overview
Install and use the SMLL command-line tool to manage your infrastructure from the terminal.
The SMLL CLI (smll) lets you manage workspaces, VPCs, services, databases, secrets, storage, and domains directly from your terminal.
Installation
Download a release binary
Download the latest binary for your platform:
# macOS (Apple Silicon)
curl -L https://s3.eu-central-1.smll.io/smll-releases/cli/latest/smll-darwin-arm64 -o smll
# macOS (Intel)
curl -L https://s3.eu-central-1.smll.io/smll-releases/cli/latest/smll-darwin-amd64 -o smll
# Linux (x86_64)
curl -L https://s3.eu-central-1.smll.io/smll-releases/cli/latest/smll-linux-amd64 -o smll
# Linux (ARM64)
curl -L https://s3.eu-central-1.smll.io/smll-releases/cli/latest/smll-linux-arm64 -o smllMake it executable and move it to your PATH:
chmod +x smll
sudo mv smll /usr/local/bin/Verify
smll version
# smll version 0.1.0Quick start
# Authenticate (opens browser)
smll login
# Set your workspace and VPC context
smll workspaces list
smll context set my-workspace my-vpc
# You're ready — manage your infrastructure
smll services list
smll db list
smll secrets listGlobal flags
| Flag | Description |
|---|---|
--json | Output JSON instead of tables |
--api-url | Override the API URL (default: https://api.smll.io, env: SMLL_API_URL) |
Configuration files
The CLI stores configuration in ~/.smll/:
| File | Purpose |
|---|---|
credentials.json | API token, user ID, email |
config.json | Active workspace and VPC context |
Both files are created with 0600 permissions (owner read/write only).