ScaleBox Docs

ScaleBox CLI Installation

Download and install the ScaleBox CLI to manage templates and sandboxes from the command line. Available for Linux, macOS, and Windows with native binaries and no dependencies.

Download and install the ScaleBox CLI to manage templates and sandboxes from the command line. Available for Linux, macOS, and Windows with native binaries and no dependencies.

✨ Latest release: ScaleBox CLI v1.3.5

v1.3.5 adds sandbox regions and locality on create (--locality-region, --locality-auto-detect, --locality-force), plus inline JSON for --object-storage (one mount or an array) and --ports. Earlier releases added template build --image-file, WebRTC TURN credentials, and port management commands.

Table of Contents

Platform Downloads

Choose the appropriate binary for your platform. All binaries are statically compiled and require no additional dependencies.

PlatformArchitectureSizeDownload
Linux x86_64For most Linux servers and desktops15MBDownload
Linux ARM64For Raspberry Pi, AWS Graviton, Apple Silicon Linux14MBDownload
macOS IntelFor Intel-based Mac computers15MBDownload
macOS Apple SiliconFor M1/M2/M3 Mac computers15MBDownload
Windows x86_64For Windows 10/11 systems16MBDownload

All binaries are statically compiled and require no additional dependencies.

Installation Verification

After installation, verify that the CLI is working correctly:

1. Check Version

scalebox-cli --version

Expected output: scalebox-cli version 1.3.5 (commit: dev, built: unknown)

2. View Help

scalebox-cli --help

Quick Setup

Get started with the ScaleBox CLI in just a few commands:

1. Authenticate with your API key

scalebox-cli auth login --api-key your-api-key --server-url https://api.scalebox.dev

Replace your-api-key with your actual API key from the dashboard.

2. List available templates

scalebox-cli template list

3. Create your first sandbox

scalebox-cli sandbox create --template tpl-abc123

System Requirements

Minimum Requirements

Operating Systems

  • Linux (glibc 2.17+)
  • macOS 10.12+
  • Windows 10+

Dependencies

  • Docker (for image operations)
  • HTTPS network access
  • ~50MB disk space

Security Verification

Verify the integrity of downloaded binaries using SHA256 checksums:

Download Checksums

Download checksums.txt

Pin this release: checksums-v1.3.5.txt

Verify on Linux/macOS

sha256sum -c checksums.txt

Ready to get started?

Continue to the Authentication Guide to learn how to connect to your ScaleBox instance, or check out the Quick Start Guide for common workflows.

On this page