Version Migration Guide

Learn how to upgrade to new versions of KFtray and KFtui.

Version Upgrades

Upgrading KFtray

1. Backup Current State

   # Backup database
   cp ~/.kftray/kftray.db backup/
   

   Copy to clipboard
2. Stop Running Processes

   # Close KFtray
   # Note: KFtui can continue running
   

   Copy to clipboard
3. Install New Version

   # macOS
   brew upgrade --cask kftray
   
   # Linux
   brew upgrade kftray-linux
   

   Copy to clipboard
4. Verify Installation

   kftray --version
   

   Copy to clipboard

Upgrading KFtui

1. Stop Running Processes

   # Close KFtui
   # Note: KFtray can continue running
   

   Copy to clipboard
2. Install New Version

   # Using installer script
   bash <(curl -s https://raw.githubusercontent.com/hcavarsan/kftray/main/hacks/kftui_installer.sh)
   

   Copy to clipboard
3. Verify Installation

   kftui --version
   

   Copy to clipboard

Process Management

Version Compatibility

Supported Versions

• KFtray: v0.10.0 and later
• KFtui: v0.15.2 and later
• Database: SQLite 3.x

Feature Support

Best Practices

Before Upgrade

• Backup database
• Stop relevant processes
• Document running forwards
• Plan upgrade timing

During Upgrade

• Follow version-specific notes
• Verify each step
• Keep backup accessible
• Monitor processes

After Upgrade

• Verify version number
• Check running forwards
• Test new features
• Update documentation

Troubleshooting

Common Issues

1. Version Mismatch
   • Verify all components upgraded
   • Check compatibility
   • Review release notes
2. Process Issues
   • Stop affected processes
   • Verify process ownership
   • Restart if necessary

Recovery Steps

1. Process Recovery
   • Identify stuck processes
   • Stop from correct interface
   • Restart application
2. Database Recovery
   • Stop all interfaces
   • Restore backup
   • Restart applications

Feature Updates

Keep track of new features and changes in the release notes.