Skip to main content
The tensor9 CLI is the primary tool for managing your Tensor9 control plane, publishing origin stacks, creating releases, and managing appliances.

​
Prerequisites

No separate Java installation is required - the CLI bundles its own runtime.

​
Installation

This installs the CLI with a bundled Java runtime. No other dependencies needed.

​
Shell script

Alternatively, install via the install script:

​
Set your API key

Set your Tensor9 API key as an environment variable:
Add this to your shell profile (~/.bashrc, ~/.zshrc, etc.) to persist it across sessions:

​
Verify installation

This should display your Tensor9 identity and environment information.

​
Updating

​
Homebrew

​
Manual update

​
Uninstallation

​
Homebrew

​
Manual

​
Platform support

The tensor9 CLI is supported on:
  • macOS (Apple Silicon and Intel)
  • Linux (arm64 and amd64)
Windows users can use the CLI through WSL (Windows Subsystem for Linux).

​
Environment variables

​
Common installation issues

Problem: tensor9: command not found after installation.Solution: If installed via Homebrew, try opening a new terminal. If the issue persists, ensure the Homebrew bin directory is in your PATH:
For Homebrew on Apple Silicon, the default path is /opt/homebrew/bin. For Intel Macs and Linux, it is /usr/local/bin.
Problem: “API key required” or authentication errors.Solution:
  1. Verify your API key is set: echo $T9_API_KEY
  2. If empty, set it: export T9_API_KEY=<your-key>
  3. Verify it works: tensor9 whoami
  4. For persistence, add to your shell profile

​
What’s next?

After installing the CLI:
  1. Set up your control plane: Follow the Quick Start guide
  2. Learn common workflows: See Common Workflows for typical tasks
  3. Reference documentation: Check the CLI Reference for all commands

​
Getting help

If you encounter issues:
  • Run tensor9 help to see available commands
  • Run tensor9 <command> -help for command-specific help
  • Contact support at [email protected]