Config directory
Kubyl uses $KUBYL_CONFIG_DIR if set, otherwise the platform config directory plus kubyl:
| Platform | Default location |
|---|---|
| macOS | ~/Library/Application Support/kubyl |
| Linux | ~/.config/kubyl |
| Windows | %APPDATA%\kubyl |
| Path | What it is |
|---|---|
settings.json | Your settings. Edit it freely. See Settings. |
settings.schema.json | JSON schema for your editor, regenerated on each start. |
state.json | Written by Kubyl: window and tab layout, favorites, saved forwards, palette recents, column choices. Never contains secrets. |
kubeconfigs/ | Kubeconfigs Kubyl owns or that you pasted. Mode 0600. |
kubeconfig-backups/ | Timestamped backups of edited kubeconfigs. Mode 0600. |
Logs
Kubyl's own logs are in ~/Library/Logs/Kubyl on macOS and in <local data dir>/kubyl/logs elsewhere. They rotate daily and the last 7 files are kept. The default level is info. Set RUST_LOG to change it, for example RUST_LOG=kubyl=debug. Attach these when you report a bug.
Other data
- Web view data (cookies and storage) is in
<local data dir>/kubyl/webview. - Tokens, refresh tokens and authorization headers are in the OS keychain: macOS Keychain, Windows Credential Manager or the Linux Secret Service.
Environment variables
| Variable | Effect |
|---|---|
KUBECONFIG | Extra kubeconfig files, when kubernetes.load_kubeconfig_env is on. |
KUBYL_CONFIG_DIR | Overrides the config directory. |
RUST_LOG | Log level. Default info. |
HTTPS_PROXY, HTTP_PROXY, NO_PROXY | Proxy settings for cluster connections, in upper or lower case. |
SHELL | On macOS and Linux, used to find your login-shell PATH for exec plugins. |
KUBYL_CREDENTIAL_STORE | file or memory. Development only. file stores credentials in plaintext JSON, memory forgets them on quit. Default is the OS keychain. |
FLATPAK_ID, SNAP | Make self-update defer to the package tool. |
Kubyl takes no command-line arguments.