Installing KFtray GUI

Follow these platform-specific instructions to install KFtray on your system.

macOS Installation

Using Homebrew (Recommended)

# Add the tap
brew tap hcavarsan/kftray

# Install KFtray
brew install --cask kftray

Manual Installation

1. Download the latest .dmg
2. Open the .dmg file
3. Drag KFtray to Applications
4. Launch from Applications folder

Linux Installation

Using Homebrew

# Add the tap
brew tap hcavarsan/kftray

# Install KFtray
brew install kftray-linux

Using AppImage

1. Download the appropriate AppImage:
   • AMD64
   • ARM64
2. Make it executable:

   chmod +x kftray*.AppImage
   

   Copy to clipboard
3. Run the AppImage

Windows Installation

1. Download the appropriate installer:
   • x64
   • ARM64
2. Run the installer
3. Follow installation wizard
4. Launch from Start Menu

Verifying Installation

1. Look for the KFtray icon in your system tray
2. Click the icon to open the main interface
3. Verify version number in About section

Post-Installation Setup

1. First Launch
   • Grant necessary permissions
   • Configure auto-start (optional)
   • Set up GitHub sync (optional)
2. System Integration
   • Enable notifications
   • Configure system tray behavior
   • Set theme preference
3. Kubernetes Setup
   • Verify kubeconfig access
   • Test cluster connectivity
   • Configure default context

Troubleshooting

Common Issues

1. Icon Not Showing
   • Restart system tray
   • Check AppIndicator support (Linux)
   • Verify installation path
2. Permission Issues
   • Check kubeconfig permissions
   • Verify application permissions
   • Review system access
3. Launch Failures
   • Check system requirements
   • Verify dependencies
   • Review error logs

Updating KFtray

Automatic Updates

• KFtray checks for updates on launch
• Follow prompts to install updates

Manual Updates

macOS:

brew upgrade --cask kftray

Linux:

brew upgrade kftray-linux

Windows:

• Download new installer
• Run installer to upgrade

Uninstallation

macOS

brew uninstall --cask kftray

Linux

brew uninstall kftray-linux

Windows

• Use Windows Settings
• Programs and Features
• Uninstall KFtray