config-commands

Configuration and Utility Commands Reference

This reference provides detailed syntax and examples for configuration, authentication, and utility Orka3 CLI commands.

Contents

• Configuration Commands
• Default Namespace Detection (v3.5.2+)
• Authentication Commands
• Utility Commands

Configuration Commands

orka3 config set

Set the Orka service URL for your environment.

Syntax:

orka3 config set --api-url <URL> [flags]

Options:

• -a, --api-url string - (Required) The Orka service URL
• -h, --help - Display help

Examples:

orka3 config set --api-url http://10.221.188.20
orka3 config set --api-url https://company.orka.app

Common API URLs:

• http://10.221.188.20 — Standard Orka 2.1+ on-premises / MSDC
• https://company.orka.app — Domain-based access (replace company with your org)
• Check with your MacStadium team or [email protected] if you don't know your API URL

orka3 config view

View the current local Orka CLI configuration.

Syntax:

orka3 config view [flags]

Default Namespace Detection (v3.5.2+)

The Orka CLI now automatically reads the default namespace from your orka kubeconfig context, eliminating the need to repeatedly specify namespaces in commands.

Namespace Resolution Hierarchy (highest to lowest priority):

1. --namespace / -n flag on command
2. ORKA_DEFAULT_NAMESPACE environment variable
3. Namespace from orka kubeconfig context
4. Falls back to orka-default

Setting a Custom Default Namespace:

# Option 1: Environment variable (session or persistent)
export ORKA_DEFAULT_NAMESPACE=my-team-namespace
orka3 vm list  # Uses my-team-namespace

# Option 2: kubectl context (persistent)
kubectl config set-context orka --namespace=orka-default

Requirements:

• Orka CLI version 3.5.2 or later
• Valid orka kubeconfig file with configured context