Skip to main content
Servers Are Up
Virtual Datacenter
PricingFree Tools
Sign inBrowse catalog
Servers Are Up
Virtual Datacenter
PricingFree Tools
Sign inBrowse catalog

Loading…

Servers Are Up

Your apps, automation and data on hardware we own. Build a private stack with predictable capacity and access through your dashboard, API or SSH.

SLA with service creditsOwned hardwareUS-based

Make room for your next idea

Explore the capacity, apps and access options that fit your workload. Check current availability and your total before you buy.

Sign up freeView Pricing

Products

  • Linux VPS
  • Windows VPS
  • Cloud & SaaS Services
  • Cloud Storage (Azure)
  • Virtual Datacenter
  • AI & Agent Hosting
  • Containers
  • Instant Apps
  • Software Platforms
  • Network builder
  • Game Servers
  • Pricing

Resources

  • Free Network Tools
  • 2026 Pricing Benchmark
  • Live SVG Badges
  • Latency & Speed Test
  • Guides & Tutorials
  • Documentation
  • API Reference
  • MCP Server
  • CLI & SDKs
  • OpenAPI & llms.txt
  • Use Cases
  • Free Migration
  • Uptime & Reliability
  • Datacenter
  • System Status
  • Network
  • Provider Comparisons Hub
  • Compare Providers

Company

  • About Us
  • Enterprise
  • Security Architecture
  • Trust Center
  • Blog
  • FAQ
  • Compliance
  • Startup Program
  • Open-Source Sponsorship
  • Press & Media Kit
  • Referral Program
  • Help Center
  • Contact Us
© Servers Are Up
TermsPrivacySLARefund PolicyDPAAcceptable Use
Service information
Docs
  • Documentation Hub
  • Choose a Product
    VMs, Containers & Cloud
  • First Linux Server
    SSH, Firewall & Apps
  • Windows Server 2025
    BYOL & Remote Desktop
  • Remote Access
  • Troubleshooting
  • FAQ
  • All Product Guides
    29 Step-by-Step Guides
  • Cloud & SaaS Catalog
    112 Cloud & SaaS Offerings
  • Azure Cloud Storage
    Hot/Cool/Archive & WORM
  • Resource Manager & RBAC
    Groups, Tags & Locks
  • Multi-Model Cloud DB
    JSONB, SQL & pgvector
  • Cloud Identity & ZTNA
    OIDC, SCIM & PIM
  • Key Vault & KMS
    Secrets & Envelope Keys
  • Cloud SIEM, SOAR & DLP
    Posture & Threat Response
  • API Gateway & Cloud DNS
    Edge WAF & DNS Zones
  • Serverless, Workflows & IoT
    Functions, Queues & DAGs
  • SaaS, Governance & Vault
    Budgets & Off-Host GRS
  • Build Web Apps with AI
  • Next.js and React
  • TypeScript and Node.js
  • npm and Tooling
  • Data and APIs
  • Deploy and Operate
  • Tutorials
  • Infrastructure
  • Automation & Regions
  • API Overview
  • API v1 Reference
    Endpoints & 23 Scopes
  • MCP Server
    129 AI Agent Tools
  • Swagger / OpenAPI 3.1
  • API Playground
  • Versioning & Sunset
  • API Token Security
    Authentication & Tokens
  • Instances API
    Compute Resources
  • Networking API
    Networks & Ports
  • Storage API Availability
    Volumes & Backups
  • Webhooks & Events
    Event Notifications
  • Rate Limits & Best Practices
    Throttling & Retries
  • sau CLI Reference
    34 Commands (v0.2)
  • Browser Web CLI
  • SDKs
  • Infrastructure as Code
    Terraform & Ansible
  • Code Examples
  • CLI & SDK Guides
  • Security Guides
  • Security at a Glance
  • Zero Trust Architecture
  • Live Trust Center
  • Compliance
Need help?

Loading documentation...

Documentation/products

Install the sau CLI and manage infrastructure from a terminal

Install @serversareup/cli v0.2.0, authenticate with a scoped token and manage servers, resource groups, locks and cloud services.

Beginner
15 min
Updated 2026-11-12

Deploy Ready-to-Run Infrastructure in Seconds

Linux VMs from $6/mo · Pooled Virtual Datacenters from $12/mo · Use code WELCOME20 for 20% off your first order.

Browse ServersView Pricing

Commands checked on 2026-11-12 with @serversareup/cli (sau) 0.2.0, Node.js 24 LTS.

What you will have at the end

You will have the official sau command-line interface (@serversareup/cli v0.2.0) installed on your workstation or CI runner, authenticated against https://serversareup.com/api/v1, configured with your preferred output format (table, json, jsonc, tsv, yaml, or none) and --query selector, and ready to operate all 34 top-level command groups across compute, SSH, billing, Resource Manager, security, storage, databases, and Managed SaaS.

Before you start

  • Node.js 20 or newer (node --version; Node.js 24 LTS recommended).
  • A scoped sau_... Personal Access Token created at Account settings > API keys (/account/api-keys). See Create a scoped API key and send your first v1 request.
  • Note on distribution: @serversareup/cli is distributed directly from Servers Are Up (https://serversareup.com/downloads/serversareup-cli.tgz) and source—it is not published on the public npm registry, and the binary is always sau.

Steps

1. Install @serversareup/cli from the signed tarball (or build from source)

Install the sau binary globally from the platform's hosted tarball, or run npx / build from packages/cli in a local checkout:

npm install -g https://serversareup.com/downloads/serversareup-cli.tgz
sau --version
sau --help

sau --version prints 0.2.0.

2. Authenticate and set your CLI & Portal defaults

Sign in interactively or pass --token (in CI/CD runners, prefer setting the SAU_API_TOKEN environment variable so nothing is written to disk):

sau auth login --token sau_your_token_here
sau auth status
sau account

Configure default output formatting, Resource Group, and region locally—or pass --remote to synchronize your Portal and AI Agent Write Guardrail preferences across /dashboard/resource-manager, CLI, and MCP:

sau config set output table
sau config set group prod-core-rg --remote
sau config set location us-central-sau-1 --remote
sau config show --remote

3. Manage servers, SSH sessions, snapshots, and power states

Use the core compute commands (instances, ssh, ssh-keys, console, snapshots, backups, catalog, orders, billing) for day-to-day VM operations:

# List servers as a formatted table or filter JSON fields with --query
sau instances list
sau -o json --query "0.id" instances list

# Inspect one server, restart it, or create a pre-deploy snapshot
sau instances get <instance-id>
sau snapshots create <instance-id> --name "before-deploy"
sau instances power <instance-id> restart

# Open an interactive SSH session using an ephemeral key lease
sau ssh <instance-id>

4. Operate Resource Manager, Cloud Storage, Databases, SIEM, and SaaS

sau v0.2.0 includes 22 Cloud Platform command groups mapped 1:1 to /api/v1/*, every one supporting -o <json|jsonc|table|tsv|yaml|none> and --query <expr>:

# Resource Groups, Tags, Locks, RBAC, Diagnostics & Quotas
sau group create prod-core-rg --location us-central-sau-1 --tags "env=prod,team=platform"
sau lock create protect-prod --group prod-core-rg --level CanNotDelete
sau role list -o table
sau quota list -o table
sau group export -f hcl -g prod-core-rg

# Azure-Hosted Cloud Blob Storage, Multi-Model Cloud DB & Key Vault
sau storage blobs-list -o table
sau cosmosdb list -o table
sau keyvault secret-set DATABASE_URL "postgresql://..." --vault default-vault

# Network Checkpoints, Cloud DNS, Cloud SIEM, Security Posture & SaaS Catalog
sau network checkpoints-list -o table
sau sentinel kql "SecurityEvent | where Severity == 'HIGH' | limit 10"
sau security posture
sau saas catalog --query "vector" -o table

You can also execute any sau ... command directly inside your browser from the Cloud Shell bar in Operations > Resource manager & settings (/dashboard/resource-manager) without installing anything locally!

Check that it works

Run a multi-format verification across account identity, quotas, and activity logs:

sau version
sau quota list -o table
sau monitor activity-log --limit 5 -o yaml

All three commands return exit code 0 with formatted output matching -o table and -o yaml.

What can go wrong

  • command not found: sau after npm install -g. Your global npm bin directory (npm prefix -g/bin) is not on your shell PATH. Add export PATH="$(npm prefix -g)/bin:$PATH" to ~/.zshrc or ~/.bashrc.
  • Missing API token in CI pipelines. Export SAU_API_TOKEN="sau_..." in the CI job's environment variables instead of calling sau auth login.
  • Destructive CLI command (sau group delete, sau cosmosdb delete, sau saas cancel) fails with 409 Conflict (RESOURCE_LOCKED). A CanNotDelete or ReadOnly lock is protecting that resource! Inspect locks with sau lock list -o table and remove the lock explicitly only if deletion is intentional.

Good practice

  • Use -o tsv or -o json --query <selector> inside shell scripts instead of parsing human table borders with awk.
  • Set sau config set aiWriteMode READ_ONLY --remote (or SAFE_MUTATIONS) when sharing a workspace with autonomous coding agents so destructive operations stay gated at the control plane.
  • Keep separate tokens for interactive laptop sau usage vs automated CI jobs so you can revoke either independently on /account/api-keys.

Where to go next

  • Organize resources with groups, tags, locks and RBAC
  • Connect an AI agent to Servers Are Up over MCP
  • Create a scoped API key and send your first v1 request

Related Articles

Create a scoped API key and send your first v1 request

Read more

Route APIs with Edge WAF, rate limits and Cloud DNS

Read more

Purchase Azure-backed cloud storage with WORM locks and SAS

Read more

Frequently Asked Questions

What does the Install the sau CLI and manage infrastructure from a terminal documentation guide cover?
Install @serversareup/cli v0.2.0, authenticate with a scoped token and manage servers, resource groups, locks and cloud services. It is rated beginner difficulty (15 min) and applies to Servers Are Up infrastructure and workflows.
Can I manage or automate these steps through the Servers Are Up dashboard, REST API v1, or MCP server?
Yes. Every Servers Are Up server includes browser-based SSH, WebRDP, and VNC console access in the dashboard, plus programmatic control via the REST API v1 (/api/v1) and hosted Model Context Protocol server (/api/mcp/v1) using a scoped Personal Access Token.

Need hands-on help with Install the sau CLI and manage infrastructure from a terminal?

Every Servers Are Up virtual machine and container includes an integrated HTML5 browser-based SSH, RDP, and VNC console in your dashboard, default-off inbound firewall rules with per-IP allow-lists, and full programmatic control via REST API v1 and Model Context Protocol (MCP). Explore our Virtual Datacenter Plans or reach out to Servers Are Up Support.

Was this article helpful?

On this page

What you will have at the endBefore you startSteps1. Install @serversareup/cli from the signed tarball (or build from source)2. Authenticate and set your CLI & Portal defaults3. Manage servers, SSH sessions, snapshots, and power states4. Operate Resource Manager, Cloud Storage, Databases, SIEM, and SaaSCheck that it worksWhat can go wrongGood practiceWhere to go next