CLI Overview

The sota command-line tool wraps the sota.io REST API for terminal-native workflows. Deploy, manage, and debug your applications without leaving the terminal.

The CLI is open source: GitHub | Releases

Commands

Command	Description
`sota login`	Authenticate with your sota.io account via browser
`sota auth set-key`	Store an API key for authentication
`sota auth status`	Show current authentication status
`sota deploy`	Deploy the current project
`sota logs`	View build and runtime logs
`sota env`	Manage environment variables
`sota rollback`	Revert to the previous deployment
`sota status`	Show current deployment status
`sota projects list`	List all your projects

Global Flags

Flag	Description
`--help`	Show help for any command
`--version`	Show CLI version

Project Linking

When you first run sota deploy in a directory, the CLI creates a .sota.json file that links the directory to a sota.io project. Subsequent commands in that directory automatically target the linked project.

{
  "project_id": "550e8400-e29b-41d4-a716-446655440000",
  "project_slug": "my-app"
}

Authentication

The CLI supports three authentication methods, checked in this order:

SOTA_API_KEY environment variable — best for CI/CD pipelines
Stored API key — set with sota auth set-key <key>
Browser login — interactive OAuth via sota login

Get your API key from the dashboard settings or create one via the API.

Output

The CLI uses colored output by default. Set NO_COLOR=1 to disable colors for CI environments.