🚀 Release 0.9.0
Changed
- Major Refactor: Split context menu, VM operations, and refresh logic into separate files for improved maintainability and DRYness.
- Improved form and modal UX, including better keyboard navigation and consistent input handling.
- Async feedback and pending state for all VM operations, including migration, with robust UI refresh and error handling.
- Robust selection restoration for both node and VM lists after refresh (fixes selection jump issues).
- Fixed linter/code-quality issues and removed duplicate or unused code.
- Updated and consolidated helpers for refresh and selection logic.
- All changes maintain code quality and pass all tests.
Added
- Guest configuration editor: Edit CPU, memory, and description for both QEMU and LXC guests.
- Storage volume resize: Resize disks from the config editor, with robust filtering for resizable volumes only.
- Interactive First-Run Setup: Added user-friendly configuration wizard for new users
- Automatically detects when configuration is missing or incomplete
- Prompts users to create a default configuration file in the XDG config directory
- Embeds the configuration template directly in the binary for offline setup
- Provides clear, friendly messaging with proper spacing and visual indicators
- Supports both
.ymland.yamlfile extensions for configuration discovery - Eliminates the need for users to manually create configuration files or read documentation first
- Startup Connectivity Verification: Added comprehensive startup sequence with real-time feedback
- Tests network connectivity and authentication before loading the main interface
- Clear console progress messages showing each startup step (config loading, client initialization, connection testing, authentication verification)
- Intelligent error categorization with specific suggestions for different failure types
- Prevents users from waiting at "Loading..." screens when configuration issues exist
- Helpful error messages pointing users to the exact config file and suggesting fixes for connection or authentication problems
- Added a reusable custom FormItem (FormButton) for use in forms.
Fixed
- VNC Connectivity: Fixed issue where VNC failed to connect when using SSH port forwarding (e.g., in VS Code). The noVNC client now uses a relative URL, allowing it to connect correctly through forwarded ports.
- Fixed: Auto-refresh countdown and periodic refresh now work correctly after a manual refresh or config edit. Enabling auto-refresh after a manual refresh no longer leaves the UI stuck in 'Refreshing...' state.
- Cleaned up auto-refresh logic: startAutoRefresh only starts ticker/goroutines if not already running, and toggleAutoRefresh only calls stopAutoRefresh when disabling.
- Fixed: Node details (kernel version, CPU model, load average, version) are now preserved after a manual refresh, matching auto-refresh behavior. Previously, these fields would disappear after manual refresh.
📦 Downloads
Choose the appropriate binary for your platform:
- Linux AMD64:
proxmox-tui-linux-amd64.tar.gz - Linux ARM64:
proxmox-tui-linux-arm64.tar.gz - macOS Intel:
proxmox-tui-darwin-amd64.tar.gz - macOS Apple Silicon:
proxmox-tui-darwin-arm64.tar.gz - Windows AMD64:
proxmox-tui-windows-amd64.zip - Windows ARM64:
proxmox-tui-windows-arm64.zip
🔐 Verification
Verify your download with the provided checksums.txt file:
shasum -a 256 -c checksums.txt📋 Installation
- Download the appropriate archive for your platform
- Extract the binary:
tar -xzf proxmox-tui-*.tar.gz(or unzip for Windows) - Make executable (Unix):
chmod +x proxmox-tui-* - Run:
./proxmox-tui-* --help