Overview

The Solsta Command Line Interface (CLI) lets you access core Solsta functionality - such as installing, updating, and launching - directly from your terminal. It integrates with agentic tools and organizational systems, enabling you to automate and streamline your workflows.

The steps in this article assume you've accepted your invitation to Solsta or created your own account.
‍

Supported Platforms

• Windows 10+
• macOS 12+
• Ubuntu 22+‍

The Solsta CLI is a standalone executable. There are no other pre-requisites or system requirements.

Quickstart‍

‍

Step 1: Download the CLI

Download the Solsta CLI at solsta.io/download

On macOS or Ubuntu, grant execute permissions before running

chmod +x /path/to/solsta_cli

‍

Step 2: Sign in

Option 1: Log in as a user

‍Type this into your terminal: 

solsta_cli login prompt

This opens a login prompt in a browser just like the Solsta Desktop Application (GUI)

Option 2: Login with Machine Credentials‍

Generate M2M Credentials in the Solsta Desktop Application first. These credentials are meant for unmanned machines or processes that do not allow login via a browser.

Type this into your terminal: 

solsta_cli login client_credentials \
  --client_id=YOUR_CLIENT_ID \
  --client_secret=YOUR_CLIENT_SECRET

‍

Note: M2M tokens expire after 24 hours. User tokens stay active as long as the CLI is used at least once every 30 days.

‍

Step 3: See what's available

List the products and environments your account has access to. These commands give you the exact names needed for install. Names are case-sensitive.

solsta_cli.exe product read

solsta_cli.exe env read --product_name=LlamaCraft

Sample Output

These are the environments available in the "LlamaCraft" product. Note the name values for each listed environment.

START - EnvironmentRead
  ProductId: da1dda56f18ca04ab3cd400d2aa391e6
STOP
  Body:
    Items:
      - Env: 010a495bd25842418bbcd47f40a6e1d3
        Org: org_3w6RoIUjFXhwg2rC
        ApprovalsRequired: 0
        CreatedTime: 1706231002        
        Description: daily builds in dev        
        Name: dev-daily
        PublishLocation: https://internal.akamaized.net/ssn-solsta/        
        SourceLocation: s3://ssn-solsta/                
        Product: da1dda56f18ca04ab3cd400d2aa391e6        
      - Env: 11752df436a65f47a6a94d255082d3da
        Org: org_3w6RoIUjFXhwg2rC        
        CreatedTime: 1693934597        
        Description: internal QA testing        
        Name: qa-internal
        PublishLocation: https://internal.akamaized.net/ssn-solsta/        
        SourceLocation: s3://ssn-solsta/                
        Product: da1dda56f18ca04ab3cd400d2aa391e6

‍‍

Once you have your product and environment names, head to Using the Solsta CLI to continue.

‍
CLI and GUI

The Solsta CLI and Desktop Application are designed to coexist on the same machine. The GUI will not reflect CLI changes in real time. Restart the GUI to see updates made by the CLI.
‍

Known Issues

A terminal error does not release a session slot from the Orchestration Service. This causes a retry of the same download on the same machine to be delayed by 10 minutes.