Configuration Guide

Learn how to configure Yamal for optimal performance and customization.

Configuration File

Yamal uses a configuration file located at ~/.yamal/config.yaml.

Basic Configuration

# Basic configuration example
clusters:
  - name: production
    server: https://prod-cluster.example.com
    auth:
      type: token
      token: your-token-here
  - name: development
    server: https://dev-cluster.example.com
    auth:
      type: kubeconfig
      path: ~/.kube/config

Preferences

Customize Yamal’s behavior through the Preferences dialog.

Appearance Settings

Setting	Options	Description
Theme	Light/Dark	Application color scheme
Font Size	10-20px	Adjust text size
Animations	On/Off	Enable/disable UI animations

Connection Settings

Configure how Yamal connects to your clusters:

Timeout: Set connection timeout values
Retries: Configure retry attempts for failed connections
Proxy: Set up proxy settings if needed

Keyboard Shortcuts

Speed up your workflow with these keyboard shortcuts:

Shortcut	Action
`Cmd+N`	New tab
`Cmd+W`	Close tab
`Cmd+Shift+C`	Copy selected resource
`Cmd+F`	Find in current view
`Cmd+,`	Open Preferences

Advanced Configuration

For advanced users, Yamal supports custom configurations through environment variables:

Variable	Description
`YAMAL_CONFIG_PATH`	Path to custom configuration file
`YAMAL_LOG_LEVEL`	Logging verbosity (debug/info/warn/error)
`YAMAL_CACHE_DIR`	Directory for caching data

Security

Yamal takes security seriously:

All credentials are stored securely in the macOS Keychain
TLS certificates are validated by default
Regular security updates are released

Security Demo

Troubleshooting Configuration Issues

If you’re having trouble with configuration:

Validate your YAML syntax
Check file permissions on config files
Ensure network connectivity to your clusters

For detailed troubleshooting, see our Troubleshooting Guide.