Harvester v1.5.0 Release Notes

This release introduces several features, enhancements, and bug fixes that improve system quality and the overall user experience. The documentation is available at https://docs.harvesterhci.io/v1.5.

The Harvester team appreciates your contributions and looks forward to receiving feedback regarding this release.

Downloads

AMD64

Full ISO

💿 https://releases.rancher.com/harvester/v1.5.0/harvester-v1.5.0-amd64.iso

📁 https://releases.rancher.com/harvester/v1.5.0/harvester-v1.5.0-vmlinuz-amd64

📁 https://releases.rancher.com/harvester/v1.5.0/harvester-v1.5.0-initrd-amd64

📁 https://releases.rancher.com/harvester/v1.5.0/harvester-v1.5.0-rootfs-amd64.squashfs

✅ https://releases.rancher.com/harvester/v1.5.0/harvester-v1.5.0-amd64.sha512

📝 https://releases.rancher.com/harvester/v1.5.0/version.yaml

Net Install ISO

💿 https://releases.rancher.com/harvester/v1.5.0/harvester-v1.5.0-amd64-net-install.iso

📝 https://docs.harvesterhci.io/v1.5/install/net-install/

ARM64

💿 https://releases.rancher.com/harvester/v1.5.0/harvester-v1.5.0-arm64.iso

📁 https://releases.rancher.com/harvester/v1.5.0/harvester-v1.5.0-vmlinuz-arm64

📁 https://releases.rancher.com/harvester/v1.5.0/harvester-v1.5.0-initrd-arm64

📁 https://releases.rancher.com/harvester/v1.5.0/harvester-v1.5.0-rootfs-arm64.squashfs

✅ https://releases.rancher.com/harvester/v1.5.0/harvester-v1.5.0-arm64.sha512

📝 https://releases.rancher.com/harvester/v1.5.0/version-arm64.yaml

Installation

Harvester can be installed using the ISO image, a bootable USB drive, and PXE boot. A net install ISO image, which contains only the core OS components, is also now available. For more information, see the Installation section of the documentation.

Upgrades

Harvester only allows upgrades from supported versions. For more information about upgrade paths and procedures, see Upgrading Harvester.

Highlights

Experimental Features

Longhorn V2 Data Engine Enhancements

Harvester v1.5.0, which uses Longhorn v1.8.1, supports the creation of virtual machine images and boot volumes using the V2 Data Engine, and live migration of virtual machines with attached V2 volumes. To leverage the enhancements, you must create a new V2 StorageClass and then use it to create images and volumes after upgrading to Harvester v1.5.0. V2 volumes created using Harvester v1.4.x remain non-migratable after the upgrade.

Demo | Documentation | GitHub issues: #7521 and #7522

Fully Supported Features

Third-Party Storage Support

Harvester now supports provisioning of root volumes and data volumes using external container storage interface (CSI) drivers. This enhancement allows you to select drivers that meet specific requirements, such as performance optimization or seamless integration with existing storage solutions.

Once the CSI driver is installed and the Harvester cluster is configured, an external storage solution can be used to store and manage virtual machine images, store virtual machine disks on volumes provisioned by the CSI driver, and perform other critical storage functions.

Demo | Documentation | GitHub issues: #1199 and #2272

ARM64 Support

Harvester v1.5.0 fully supports deployment on hosts with ARM architecture. This includes add-ons, which were previously packaged only for AMD64-based hosts, and upgrade paths for ARM-only clusters. Harvester on ARM is fully tested, stable, and ready for mission-critical workloads.

Documentation | GitHub issue: #6257

Features

• [GUI] [FEATURE] Consume external/third-party storage within Harvester #7572
• [FEATURE][UI] Add EFI persisent state checkbox in VM advanced tab #7557
• [FEATURE] Longhorn v2 data engine - live migration #7522
• [FEATURE] Longhorn v2 data engine - boot volume support #7521
• [GUI] [FEATURE] Add support for persistent TPM in VMs #7187
• [FEATURE] [GUI] Disable Harvester UI extension for v1.2 clusters #6971
• [FEATURE] Add support for persistent TPM in VMs #6731
• [FEATURE] Support EFI mode in harvester node driver #4777
• [FEATURE] Modify the default cluster-cidr of harvester #4254
• [FEATURE] Use @rancher/shell in the harvester/dashboard repo #4189
• [FEATURE] Consume external/third-party storage within Harvester #1199

Enhancements

• [Enhancement] UI should able to config the volumeMode when add the new volume #7875
• [ENHANCEMENT] v1.5.0 Bump monitoring and logging #7404
• [ENHANCEMENT][UI] Add confirmation pop-up for VM stop and pause actions #7382
• [ENHANCEMENT] Do not shutdown harvester upgrade-repo VMs in multiple-node cluster upgrade scenario #7373
• [ENHANCEMENT] Checking Backup Target Setting and Compatibility with LH v1.8 #7335
• [GUI] [ENHANCEMENT] Improve Single-Replica Volume Detection for Upgrade #7328
• [ENHANCEMENT] Improve Single-Replica Volume Detection for Upgrade #7323
• [ENHANCEMENT] Fix kube-version constraint in harvester-cloud-provider #7321
• [ENHANCEMENT] Reject VM Backup Creation if the Volume Provider is not LH #7316
• [ENHANCEMENT] Harvester CSI Driver Controller should only deploy on the control plane nodes. #7189
• [ENHANCEMENT] Update kubevirt arm image packaging #7098
• [ENHANCEMENT] Add essential checks on (cluster)flow and (cluster)output #7064
• [ENHANCEMENT] Add certs expiration validation for Upgrade CR #7056
• [ENHANCEMENT] Improve Managed DHCP to sync VM MAC address changes and allow network config updates #7046
• [ENHANCEMENT] Bump Harvester CSI Driver 0.1.21 to Rancher/RKE2 #6991
• [ENHANCEMENT] Ensure the destination directories exist before starting downloads in the image-preload phase of Harvester Upgrade [#6963](#696
• [ENHANCEMENT] Harvester installer supports to input MAC for VIP in DHCP mode #6960
• [ENHANCEMENT][GUI] Disable Filter Schedule button if there is no backups/snapshots created by schedule job #6949
• [ENHANCEMENT][GUI] cluster output select dropdown should show meaningful sentence if no options available #6946
• [ENHANCEMENT] VM Image Multiple Backend Support #6936
• [ENHANCEMENT][GUI] Move enable CPU Pinning checkbox position in template config page #6879
• [ENHANCEMENT] Bump harvester-node-driver to v0.7.1 #6829
• [ENHANCEMENT] Prevent users from selecting invalid storage class when creating image #6792
• [ENHANCEMENT] Support sha512 and other parameter options for volume encryption #6789
• [ENHANCEMENT] Harvester-cloud-provider allows user to mark more IPs as none-external IPs #6751
• [ENHANCEMENT] VMs with dedicatedCpuPlacement=true should be shut down at forced maintenance mode #6732
• [OpenStack] Make timeout during waiting for uploadImage configurable #6675
• [ENHANCEMENT] DeviceName (Resource Name) in HostDevices/GPUs should be verified #6542
• [ENHANCEMENT] seeder improvements #6535
• [ENHANCEMENT] The vm-importer should do more logging #6512
• [GUI] [ENHANCEMENT] Support untagged VLAN for storage network #6501
• [ENHANCEMENT] There's No UI Way for User to know VM Import is Failing due to exeeding naming character limit #6463
• [ENHANCEMENT] Add the wipe_disks option in the installation panel #6304
• [ENHANCEMENT] Upgrade support of ARM64 #6257
• [ENHANCEMENT] Provide User Info When Storage Network Is Configured Incorrectly #6256
• Allow Terrafrom provider to accept kubeconfig as base64 string #6234
• [ENHANCEMENT] Having a "real-time" progress displayed during installer's "Downloading ISO..." phase #5990
• [GUI] [ENHANCEMENT] Add Labels tab to Virtual Machines page #5974
• [ENHANCEMENT] Examine for duplicated MAC addresses when creating new VMs in the Harvester cluster #4893
• [ENHANCEMENT] Support untagged VLAN for storage network #4323
• [FEATURE] NFS/shared storage for virtual machines #2272

Bug Fixes

• [BUG] You get errors when you create multiple VMs using the same template #8104
• [BUG] Still fail to start VM even following error message to correct an invalid VM name #8098
• [BUG] Can't detach Nvidia GPU pci device from VM after upgraded to v1.5.0-rc4 #8071
• [BUG] VM creation from template shows secret error 1.5.0-rc4 #8038
• [BUG] Image download API reply before image ready #8027
• [BUG] unexpected volume shows when adding to VM #8023
• [BUG] v1.5.0 upgrade looks broken after bump rancher to v2.11.0 #8001
• [BUG] Change nvidia-driver-runtime chart's default pullPolicy from "Always" to "IfNotPresent" #8000
• [BUG] Upgrade stuck at Upgrading System Service phase due to reach the specified backoff limit #7990
• [BUG] Harvester cluster status keep in NotReady on the second joined node from iso installation #7963
• [BUG] Can't upload images to Longhorn v2 3rd party storage classes #7957
• [BUG] AirGap Upgrades Seem Blocked with Fluentbit/FluentD #7955
• [BUG][UI] UI broken when error during migrate VM #7954
• [BUG] Via Rancher, config Selector on an existing ranged IPPool causes it "Not Ready" #7942
• [BUG] CVE-2025-1974 Vulnerability #7941
• [BUG][UI] The volume won't dismiss after delete action confirmed #7925
• [BUG] Upgrade a witness cluster with default storage class will stuck in Pre-draining #7923
• [BUG] Can Not Add Extra Disks w/ Rancher 2.10.2||2.10.3 & Harvester UI v1.0.4 & Harvester v1.4.1||v1.5.0-rc1 #7919
• [BUG] Can't download image from LVM third party storage cluster #7899
• [BUG] Custom "Image Repository" for nvidia-driver-toolkit Addon Not Working #7896
• [BUG] Harvester upgrade controller does not handle "no such host" error when cleaning images #7891
• [BUG] High load and use of cpu time by harvester process #7885
• [BUG] third party storage LVM volume export to VM image failed #7883
• [BUG] third party storage LVM image won't upload #7882
• [BUG] Error message when removing longhorn v2 disks after disabling #7876
• [BUG] Can't export volume to image with Longhorn v2 external storage #7854
• [BUG] Upgrade 1.4.0 -> 1.4.1 stuck: instance-manager ... count is not 1 #7840
• [BUG] Upgrade from v1.4.2-rc2 to v1.5.0-rc1 stuck #7819
• [BUG] Can't pass through PCI device due to unloaded vfio module in few hours #7815
• [BUG] upgrade controller does not handle read-message well due to UI menu Dismiss it wipes upgrade CR's status #7791
• [BUG][GUI] Prevent user from changing VolumeSnapshotClass with driver.longhorn.io #7768
• [BUG] Setting Backup Target's refreshIntervalInSeconds will have error #7764
• [BUG] Checking/Fixing VMBackup compatibility with Third-party Storage #7755
• [BUG] VM Snapshot Resotere can't Automatically Boot Up if the Source VM has 3rd party storage #7739
• [BUG][GUI] Disable backupVolumeSnapshotClassName in setting csi-driver-config for third party storage #7737
• [BUG] v1.4.2-rc2 Install Binaries Only, error applying a fake default route during installOnlyMode: exit status 2 #7732
• [GUI] [BUG] Backups not appearing on second cluster using shared backup storage #7693
• [BUG] auto-disk-provision-paths not working on 1.4.1 #7668
• [BUG] UpgradeLog does not cleanup managedchart all the time #7654
• [BUG] Enhance upgradeLog to adapt with rancher-logging stack bumping #7652
• [BUG] The virtctl on upgrade needs to be bumped #7648
• [BUG] When assigning SSH key to new VM it doesn't save the SSH key #7632
• [BUG] Harvester ISO installation is broken #7622
• [BUG] VM controller calculates ResourceQuota with wrong assumption #7585
• [BUG] No progress circle on the top after triggering upgrade #7578
• [BUG] Parsing error in the Managed DHCP agent image name #7549
• [BUG] When adding an SSH key from the VM creation page the browser page freezes #7544
• [BUG] Restoring VM Backup to another Namespace or another Cluster is Broken #7539
• [BUG] v1.5.0-dev-20250203 Can't Add Secondary Storage To Host #7516
• [BUG][UI] VM lock icon suddenly displayed even not create from encrypted image #7510
• [BUG] [UI] Missing harvester upgrade status in Rancher WebUI #7484
• [BUG] Harvester v1.4.1 IP exhaustion #7471
• [BUG] Installer crashes when given malformed kernel command line arguments #7470
• [BUG] docker-machine-driver-harvester fails to provision VM's with using Node/VM Scheduling when using long VM / Namespace names [#7467](#746
• [BUG] Error during migration of VMs with long names when namespace resource quotas are setup #7464
• [BUG] Stuck upgrade from 1.4.0 to 1.4.1 #7457
• [BUG] Join fails when using custom CA certs #7453
• [BUG] Guest Kubernetes Cluster Loadbalancer IP assignment can become permenently stuck in IPAM mode #7449
• [BUG] Harvester managedchart is marked as harvester-snapshot-validation-webhook modified #7442
• [BUG] Harvester managedchart report post-upgrade hooks (longhorn-post-upgrade) failed: context deadline exceeded #7441
• [BUG] Change how installer configures multipath when not booting of external disks #7438
• [BUG] The VM importer fails to check the OpenStack source network exists #7432
• [BUG] Harvester fails to create vm via Edit as Yaml from UI #7408
• [BUG] Fail to trigger v1.4.0 to v1.4.1-rc1 upgrade on witness cluster due to managed chart harvester is not ready #7375
• [BUG][UI] draggable volume UI component disappears in harvester latest ISO build #7363
• [BUG] Unable to passthrough any PCIe devices on Harvester 1.4.0 #7354
• [BUG] VM Import Controller On AirGapped Harvester Cluster v1.4.0 & v1.4.1-rc1 -> Pod Stuck in ImagePullBackoff out of box #7351
• [BUG][GUI] incorrect storage network formula in the UI #7330
• [BUG] DHCP Check for Default Route breaks when using Static IP Addresses in Automated Mode #7280
• [BUG] Cluster member role user should not be able to delete node on Harvester Hosts page on Rancher managed Harvester #7255
• [BUG] Upgrade from 1.3.2 to 1.4 hanging on single-node cluster #7246
• [BUG] Harvester CSI fails to enumerate network interfaces when /sys/class/net contains non-directory entries #7232
• [BUG] Unable to configure the storage network setting to associate with the default mgmt cluster network #7212
• [BUG] [UI] Missing vnc reconnecting label #7182
• [BUG] Fix the race between Rancher and Harvester on resourcequota when VM is migrating #7178
• [BUG] rancher/rancher-agent:v2.9.2 image missing in the Harvester ISO #7157
• [BUG] mutations.js:42 TypeError: Cannot read properties of undefined (reading 'volumeAttributes') #7150
• [BUG] [UI] Generate Support Bundle button not working in Rancher/Harvester #7147
• [BUG] Terraform provider crashes with panic if disk type is "cd-rom" and disk size is not set #7139
• [BUG] Current free disk space check does not honor the settings for harvesterhci.io/minFreeDiskSpaceGB: "9" #7131
• [BUG] VM encounter the IOError with hotplug volume when the owner node enter the maintenance mode #7128
• [BUG] Harvester VM Metrics Are Not Accurate #7086
• [BUG] Backups not appearing on second cluster using shared backup storage #7083
• [BUG] Migrated VMs seem not to move in Host/Virtual Machines view #7082
• [BUG] Pod guest-consloe-log Terminated during Migrating VM on Upgrading harvester #7068
• [BUG] Two machine instances are existing upon one node and cause the node stuck on cordon state #7065
• [BUG][GUI] table header alignment is not work in harvester-ui-extension #7058
• [BUG] Crash when VirtualMachineTemplateVersion contains bogus JSON data #7051
• [BUG] VM unable to reach Harvester VIP / Node IP after RKE2 restart #7041
• [BUG][GUI] PCI Devices page bugs #7040
• [BUG] Harvester doesn't appear to be able to find userdata/metadata mounted device #7017
• [BUG] Upgrade stuck with Pre-draining due to fail to migrate a Running VM with Container Disk #7005
• [BUG] Harvester UI shows incorrect number of vGPU allocated to the VM #7003
• [BUG][GUI][Rancher Integration] Load Harvester UI extension on Rancher 2.10 shows temp error #6996
• [BUG] Rancher attach volume to the wrong VM and cause workload stuck #6981
• [BUG] filter iscsi nics misses interfaces with vlan ids #6964
• [BUG][GUI] cluster ouput/output edit output buffer got schema error #6945
• [BUG] vm-dhcp-controller dhcpserver-agent Pod Fails to Start in Air-Gapped Environment Due to ImagePullPolicy 'Always' Setting #6942
• [BUG][GUI] Remove Chinese translation for harvester standalone mode #6928
• [BUG] Fix CI failure Test_vmWithPCIDevices #6919
• [BUG][GUI] Can not add new secret via add secret modal in out-of-band access tab #6913
• [BUG] Files that should be unique per node (e.g. /etc/machine-id) are idential across all harvester nodes for a given release #6911
• [BUG] VM with assigned PCI GPU can not start after v1.3.2 to v1.4.0-rc4 upgrade due to no /dev/vfio/xx path #6892
• [BUG][GUI] vm-force-reset-policy setting can't save successfully #6889
• [BUG][GUI] edit ntp-servers setting page is empty #6888
• [BUG][GUI] default-vm-termination-grace-period-seconds setting can't save successfully #6887
• [BUG][GUI] backup target setting bug #6885
• [BUG][GUI] Storage Classes page bug #6884
• [BUG][GUI] USB device page bugs #6883
• [BUG][GUI] vGPU page bugs #6882
• [BUG][GUI] YAML tab is not needed in secret detail page #6881
• [BUG][GUI] Cloud Configuration Template list can't display correctly #6880
• [BUG][GUI] VM deleting modal is not dismiss after click delete #6878
• [BUG] UI VM Labels function seems not working #6877
• [BUG][GUI] UI branding edit page route is wrong, the whole page totally broken #6873
• [BUG][GUI] YAML tab is not needed in detail page #6872
• [BUG][GUI] Cluster metrics are unable to load in dashboard detals/summary tabs #6871
• [BUG] Upgraded harvester-csi-driver from 104.0.1+up0.1.18 to 104.0.2+up0.1.20 make PV attach failed #6849
• [BUG] Rancher resources YAML is unavailable #6846
• [BUG] harvester-cloud-provider roll out different image in Rancher cross-upgrade (Community <-> Prime) #6799
• [BUG] Issues Scaling Down RKE2 Cluster w/ Rancher v2.9.3-alpha5 (upgraded from v2.9.2) & Harvester v1.3.2 w/ Harvester Node Driver v0.7.0 [#6775](https://github.com/harvester/harvester/i
• [BUG] Image lists looks weird after upgrade purging images #6691
• [BUG] UI filter disappears when something change in PCI devices #6660
• [BUG] failure if VM name is not RFC 1123 compliant in OpenStack #6673
• [BUG] Harvester Terraform Provider 0.6.5 errors when provisioning VM #6647
• [OpenStack] VM Import Controller uses too much memory during QCOW2 conversion phase #6674
• [BUG] BIOS based VMs imported from VMWare and OpenStack has no IP address #6644
• [BUG] User can still select witness node as the target for VM creation #6592
• [BUG] harvester.install.wipe_disks=true option is overzealous #6533
• [BUG] Unable to disable kube-vip in harvester-cloud-provider chart #6527
• [BUG] OpenStack VM Import Can't Handle Source VM if Source VM has Camel Case #6505
• [BUG] virtualMachineName must be the ID of the OpenStack server when importing. #6500
• [BUG] VM Import Webhook (vSphere) Doesn't Reject Object if NetworkMapping is incorrect #6491
• [BUG] VM Import VMs Don't Copy Source Descriptions #6464
• [BUG] managed dhcp works sporadicaly #6419
• [BUG] Terraform Provider: Timeout when deleting Volume #6415
• [BUG] The hints on the branding page is using the wrong product name #6341
• [BUG] VM cannot fully utilize the defined Resource Quota (Memory Limit) #6293
• [BUG] Creating an IPPool whose name differs from its associated network's causes IP allocation issues for Managed DHCP #6240
• [BUG] Rancher deployed on arm machines cannot provision Harvester VM's #6053
• [BUG] No IP address assigned and display on virtual machine when create vm with two vlan network #5276
• [BUG/FEATURE] Harvester mgmt network blocks specific HTTPS traffic on attached VLANs #4359
• [BUG] Unable to create Cluster Output/ Output via edit yaml #3877
• [BUG] Prometheus has warning message of Evaluating rule failed against KubeVirtComponentExceedsRequestedMemory #3792
• [BUG] When we add another management network to VM and save. VM keeps in Starting state #3739
• [BUG] Request IP from windows DHCP server failed during installation #3428
• [BUG] harvester storage class volumes are not cleaned up if the harvester node driver cluster is deleted #2825
• [BUG] RKE2 cluster nodes log flooded with warnings about tainted node #2549

Others

• [DOC] Adjusting CDI filesystemOverhead to prevent scratch volume space shortage #8039
• [DOC] The documentation should mention that time synchronization is totally important #7975
• [DOC] Add note about imported VMs and third-party storage #7843
• [DOC] Fixing Misleading content for 3rd Party Storage VM Backup #7738
• [DOC] Provide steps to install Harvester UI extension in Rancher 2.10 #7409
• [DOC] Current limitation for the Managed DHCP feature #7272
• [DOC] Best practices for storage network configuration #7222
• [BUG] extension fails to load with rancher 2.10.0 and harvester 1.4 #7234
• [FEATURE][GUI] setup release CI pipeline for harvester-ui-extension #7089
• [DOC] Collect node bundle when a node is down #6831
• [DOC] Mention the importance of excluding IP addresses when configuring the storage network setting #6600
• [ENHANCEMENT] Add test to make sure node-manager docker image works #5783

Known Issues

• [BUG] Can NOT delete an oversized Not Ready volume #8096 [Documentation]
• [BUG] infinite image download loop using LVM storage driver #7993 [Documentation]
• [BUG] SMM is not enabled when TPM is enabled in VMware source client #7984
• [BUG] AirGap Upgrades Seem Blocked with Fluentbit/FluentD #7955 [Documentation]
• [BUG] Setting a fully-qualified Hostname in the Harvester Installer causes installation to fail #7312 [Workaround]
• [BUG] Host info showing hardware-based virtualization is disabled on arm server #5366

Components

Contributors

Thank you to all the contributors that made this release possible.

@a110605
@aalves08
@albinsun
@asettle
@atoy3731
@bk201
@brandboat
@dharmit
@forbesguthrie
@FrankYang0529
@houhoucoop
@ibrokethecloud
@ihcsim
@innobead
@irishgordo
@jbrockmeyer
@jillian-maroket
@khushboo-rancher
@kursataktas
@lanfon72
@LucasSaintarbor
@m-ildefons
@macedogm
@mingshuoqiu
@noahgildersleeve
@ParadoxGuitarist
@rebeccazzzz
@rrajendran17
@simonfogliato
@starbops
@torchiaf
@tserong
@TachunLin
@votdev
@Vicente-Cheng
@w13915984028
@WebberHuang1118
@yasker
@Yu-Jack