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/Windows
Download the binary for your architecture with PowerShell:
# Windows (x86_64)
curl.exe -L https://s3.eu-central-1.smll.io/smll-releases/cli/latest/smll-windows-amd64.exe -o smll.exe
# Windows (ARM64)
curl.exe -L https://s3.eu-central-1.smll.io/smll-releases/cli/latest/smll-windows-arm64.exe -o smll.exeThen put it somewhere on your PATH. For a per-user install that needs no
administrator rights:
$dir = "$env:LOCALAPPDATA\Programs\smll"
New-Item -ItemType Directory -Force -Path $dir | Out-Null
Move-Item -Force .\smll.exe "$dir\smll.exe"
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", "User") + ";$dir",
"User"
)Open a new terminal afterwards so the updated PATH takes effect.
SmartScreen may warn on first run, because the binaries are not code-signed
yet. Choose More info → Run anyway, or unblock the file first with
Unblock-File .\smll.exe.
smll works in PowerShell, Windows Terminal, cmd.exe, and WSL, though under
WSL you want the Linux binary, not the .exe.
Verify
smll version
# smll version 0.2.1Quick 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/ (%USERPROFILE%\.smll\ on Windows):
| 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). Windows
has no POSIX mode bits, so there the files inherit the ACL of your user profile
directory, which is already restricted to your account.