CLI Configuration

Learn how to configure the Helmbay CLI for your specific needs and environment.

Configuration File

The CLI looks for configuration in the following locations:

Platform	Path
Linux/macOS	`~/.config/helmbay/config.yaml`
Windows	`%APPDATA%\helmbay\config.yaml`

Configuration Options

api

object Required

API connection settings

Option	Type	Description	Default
url	string	API endpoint URL	https://api.helmbay.com
token	string	API authentication token	-

defaults

object

Default settings for commands

Option	Type	Description	Default
organization	string	Default organization name	-
repository	string	Default repository name	-

output

object

Output formatting options

Option	Type	Description	Default
format	string	Output format (table\|json\|yaml)	table
color	boolean	Enable colored output	true

Example Configurations

Basic Configuration

Minimal required configuration

api:
  url: https://api.helmbay.com
  token: your-api-token

defaults:
  organization: my-org
  repository: my-charts

Advanced Configuration

Configuration with all options

api:
  url: https://api.helmbay.com
  token: your-api-token
  timeout: 30

defaults:
  organization: my-org
  repository: my-charts
  team: frontend-team

output:
  format: json
  color: true

proxy:
  http: http://proxy.company.com:8080
  https: https://proxy.company.com:8080
  no_proxy: localhost,127.0.0.1

Environment Variables

Configuration can also be set using environment variables, which take precedence over config file values.

HELMBAY_API_TOKEN

API authentication token

export HELMBAY_API_TOKEN=your-api-token

HELMBAY_API_URL

API endpoint URL

export HELMBAY_API_URL=https://api.helmbay.com

HELMBAY_CONFIG

Custom config file path

export HELMBAY_CONFIG=/path/to/config.yaml

HELMBAY_ORG

Default organization

export HELMBAY_ORG=my-org

Next Steps

Now that you've configured the CLI, learn how to integrate it with your CI/CD pipeline.

CI/CD Integration Guide →