Upsun CLI
The full power of Upsun in your terminal. Manage projects, push code, SSH into environments, and automate workflows.
Building application ‘myapp’…
✓ Environment deployed: https://feature-login-abc123.upsun.app
app@feature-login:~$ _
Install
Choose your platform
Windows (Scoop) requires the Extras bucket
Authenticate
Log in via your browser
Running upsun opens a browser login flow and generates SSH certificates for secure access.
Use upsun login to force a re-authentication.
For CI/CD pipelines and automation, use API tokens instead.
Use
Common commands
AI Coding Agents
Teach your AI coding agent to manage Upsun projects using the CLI.
Upsun Skills
Upsun Skills is an open-source skill that gives AI coding agents like Claude Code full access to 130+ Upsun CLI commands across 30 namespaces — deployments, environments, backups, databases, scaling, and more.
Install as a Claude Code plugin
Or add manually to your project
What your agent can do
Deploy & manage environments
Push, branch, merge, and sync with production safety patterns
Backup & restore
Create backups, verify integrity, and restore with confirmation checks
Database operations
Manage PostgreSQL, MongoDB, Redis, and Valkey services
Scale & configure
Adjust resources, manage domains, and configure autoscaling
Features
Everything you need to manage projects, environments, and deployments from the terminal.
Auto-detection
Detects project and environment from your local checkout. Override with —project and —environment.
More than Git
Commands like upsun push add options like —activate and —no-wait.
Customizable
Configure via ~/.upsun-cli/config.yaml. See GitHub.
Automation-ready
Set UPSUN_CLI_NO_INTERACTION=1 to bypass prompts in CI/CD.
Autocompletion
Enable tab completion with or via Homebrew.
SSH built-in
Creates SSH certificates automatically on login. Access environments with upsun ssh.
Documentation
Dive deeper into CLI capabilities, authentication, and project setup.
Maintenance
Keep your CLI up to date and resolve common issues.
Update
Troubleshooting
RootNotFoundException
If you cloned via Git directly, run:
Upgrading from legacy CLI? Follow the installation steps above — the new CLI guides you through removal.
Ready to get started?
Install the CLI and start managing your projects from the terminal.