Cluster Configuration

Project-Level Config

Create a .helm-me.toml file in your project root to set default cluster settings:

[kubernetes]
kubeconfig = "~/.kube/staging.yaml"
context = "staging-eu"
namespace = "my-team"

Now helm-me deploy deploy.yaml uses these defaults without flags.

Priority Order

Settings are resolved in this order (first wins):

1. CLI flags (--kubeconfig, --context, --namespace)
2. Project config (.helm-me.toml)
3. Environment variable ($KUBECONFIG)
4. Default (~/.kube/config)

Multi-Cluster Workflow

# Deploy to staging
helm-me deploy deploy.yaml --context staging

# Deploy to production
helm-me deploy deploy.yaml --context production --namespace prod

XDG Config

Global settings are stored in $XDG_CONFIG_HOME/helm-me/ (defaults to ~/.config/helm-me/).

The deployment registry lives at ~/.helm-me/deployments/.