Output and Debugging
2 min
min

Output and Debugging

Machine-readable output and exit codes

Every CLI session exits with a code. These options apply to Solsta CLI version 7.2.80 and later.

Output Format

Use the --out flag to control the format of session output.

  • --out=json - Formats all output as JSON
  • --out=minify - Removes line breaks and extra spaces
  • --out=json,minify - Single-line JSON, ideal for log parsing and automation

solsta_cli product read --out=json,minify

Status Interval

By default the CLI prints a progress status every 30 seconds. Use --status_interval to change this.

  • 0 - Print immediately
  • -1 - Disable interval output
  • Any integer - Set interval in seconds
solsta_cli local update \  
--location=c:/builds/lc/dev/ \  
--status_interval=60


Debug Logging

The --debugfile flag writes a solsta_cli.log to your desktop. This log is required when opening a support ticket.

  • --debugfile - Writes log to the user desktop (recommended)
  • --debug - Writes log to the OS-default Solsta log directory
solsta_cli local update \  
--location=c:/builds/lc/dev/ --debugfile


Exit Codes

  • 0 - Success
  • 1 - Help displayed, no operation was run
  • 2 - Error, check the error section for details
  • 3 - Elevation required, rerun as administrator

Suppressing Expected Errors

Use --expected to suppress known error codes and return exit code 0 instead of 2.

solsta_cli local update \  
--location=c:/builds/lc/dev/ \  
--product_name=LlamaCraft \  
--env_name=dev-daily \  
--expected=404


Always use --debugfile when troubleshooting. The log file contains critical information required by the Solsta support team.