Configuration & Auth
orcher config
Manage CLI configuration. The config file is stored at ~/.orcher/config.yaml and uses kubectl-style contexts for managing multiple environments.
config view
1orcher config view [--raw]config get-contexts
1orcher config get-contextsLists all configured contexts.
config use-context
1orcher config use-context <context>23# Example4orcher config use-context productionconfig set-context
1orcher config set-context <context> [OPTIONS]23# Examples4orcher config set-context production --server https://orcher.example.com --namespace prod --timeout 605orcher config set-context local --server http://localhost:8080| Option | Description |
|---|---|
--server | Server URL |
--namespace | Default namespace |
--timeout | API timeout (seconds) |
config set / config unset
1orcher config set <key> <value>2orcher config unset <key>34# Examples5orcher config set namespace production6orcher config set output jsonconfig delete-context
1orcher config delete-context <context>config test-connection
1orcher config test-connection [OPTIONS]23# Examples4orcher config test-connection5orcher config test-connection --context production6orcher config test-connection --server https://orcher.example.comorcher auth
Manage authentication. Tokens are stored securely in your platform's keychain (macOS Keychain, Linux Secret Service, Windows Credential Manager).
auth login
1orcher auth login [OPTIONS]23# Device flow (OAuth)4orcher auth login --device --provider github56# Token-based7orcher auth login --token89# Basic auth10orcher auth login --username user@example.com1112# Specify server13orcher auth login --server https://orcher.example.com --device| Option | Description |
|---|---|
--server | Server URL to authenticate against |
--token | Token-based authentication (prompts for token) |
--device | OAuth device flow (opens browser) |
--provider | OAuth provider: github, google, microsoft (requires --device) |
-u, --username | Username for basic auth (prompts for password) |
The ORCHER_TOKEN environment variable takes highest priority over any stored credentials.
auth logout
1orcher auth logoutRemoves stored credentials for the current context.
auth status
1orcher auth statusShows current authentication status.
orcher completion
Generate shell completion scripts.
1orcher completion <shell>23# Examples4orcher completion bash >> ~/.bashrc5orcher completion zsh >> ~/.zshrc6orcher completion fish > ~/.config/fish/completions/orcher.fishSupported shells: bash, zsh, fish, powershell, elvish
Configuration File
The CLI configuration lives at ~/.orcher/config.yaml and uses kubectl-style contexts for managing multiple environments.
Example Configuration
1current-context: local2current-profile: default34contexts:5 local:6 server: "http://localhost:8080"7 auth:8 type: none9 timeout: "30s"10 namespace: default1112 production:13 server: "https://orcher.example.com"14 auth:15 type: token16 token-ref: prod-token17 tls:18 insecure: false19 ca-cert: /path/to/ca.pem20 client-cert: /path/to/cert.pem21 client-key: /path/to/key.pem22 timeout: "60s"23 namespace: prod2425profiles:26 default:27 output: table28 namespace: default29 log-level: info30 show-managed-fields: falseAuth Types
Each context can use one of four auth types:
- none — No authentication (local development)
- token — Bearer token (stored in keychain, referenced by
token-ref) - apikey — API key (stored in keychain, referenced by
apikey-ref) - basic — Username/password
TLS Configuration
Each context can optionally configure TLS:
1contexts:2 secure-server:3 server: "https://orcher.example.com"4 tls:5 insecure: false # Set true to skip verification6 ca-cert: /path/to/ca.pem7 client-cert: /path/to/cert.pem8 client-key: /path/to/key.pemEnvironment Variables
| Variable | Description |
|---|---|
ORCHER_CONFIG | Config file path (default: ~/.orcher/config.yaml) |
ORCHER_CONTEXT | Override current context |
ORCHER_NAMESPACE | Override namespace |
ORCHER_SERVER | Override server URL |
ORCHER_TOKEN | API token (highest priority, overrides stored credentials) |
ORCHER_REDIS_URL | Redis connection string |
ORCHER_API_URL | REST API address (the engine's HTTP port); defaults to the --server host on port 8080 |
ORCHER_VERBOSE | Enable verbose logging |
ORCHER_QUIET | Quiet mode |
NO_COLOR | Disable colored output |
DATABASE_URL | Database URL (for server start) |
File Paths
| Item | Path |
|---|---|
| Config directory | ~/.orcher/ |
| Config file | ~/.orcher/config.yaml |
| Templates | ~/.orcher/templates/ |
| Cache | ~/.orcher/cache/ |
| Logs | ~/.orcher/logs/ |
| Credentials | OS keychain (not on disk) |