Skip to main content

CLI Installation

Before you can start using Strata CLI, you need to install it on your system. This guide covers Ruby and Git prerequisites, platform-specific setup, and CLI installation.

Requirements​

  • Ruby: 3.4.4 or higher (required for Strata CLI)
  • Git: Required for deployment, migrations, and version-controlled projects (install from git-scm.com)

Checking Ruby and Git​

Verify versions before installing:

ruby --version   # Should be 3.4.4 or higher
git --version   # Any recent version is fine

If Ruby is missing or too old, install or upgrade using the instructions below for your platform.

Platform-Specific Setup​

Homebrew (recommended):

brew install ruby

Or use the system Ruby if it meets 3.4.4+ (check with ruby --version). For the latest Ruby, consider rbenv or asdf.

Install Strata CLI​

This installs Strata CLI globally so you can run strata from any directory.

curl -fsSL https://strata.do/cli/install.sh | bash

This script checks for Ruby and Git prerequisites, installs the CLI gem, and verifies the installation.

Verify Installation​

After installation, verify that Strata CLI is installed correctly:

strata version

This command displays the installed version of Strata CLI.

Getting Help​

To see all available commands, run:

strata

For detailed help on any command, use:

strata COMMAND --help

The CLI help system provides comprehensive documentation for each command, including options, examples, and usage patterns.

Next Steps​

Now that you have Strata CLI installed, you're ready to start creating your first Strata project!