From 297fc0165350656d6dcc2355790d6fffc77d8306 Mon Sep 17 00:00:00 2001 From: Tim Serong Date: Wed, 14 Jan 2026 16:51:36 +1100 Subject: [PATCH] enhancement: drop BIOS support for new installs We need to eventually remove support for legacy BIOS systems. Ensuring new installs can only be performed on UEFI systems is part of that journey. Related-to: https://github.com/harvester/harvester/issues/9854 Related-to: https://github.com/harvester/harvester/issues/9855 Signed-off-by: Tim Serong --- docs/install/iso-install.md | 10 +++++----- docs/install/requirements.md | 2 +- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/install/iso-install.md b/docs/install/iso-install.md index 453aff4162..c539aed248 100644 --- a/docs/install/iso-install.md +++ b/docs/install/iso-install.md @@ -18,6 +18,10 @@ description: To get the Harvester ISO, download it from the Github releases. Dur Harvester ships as a bootable appliance image, you can install it directly on a bare metal server with the ISO image. To get the ISO image, download **💿 harvester-v1.x.x-amd64.iso** from the [Harvester releases](https://github.com/harvester/harvester/releases) page. +:::info important +Support for legacy BIOS booting was deprecated in v1.7.0 and will be removed in a later release. Existing Harvester clusters that use this boot mode will continue to function, but upgrading to later versions may require re-installation in UEFI mode. Starting with Harvester v1.8.0, the installer ISO will not boot on legacy BIOS systems in order to ensure that UEFI is used for all new installations. +::: + During the installation, you can either choose to **create a new Harvester cluster** or **join the node to an existing Harvester cluster**. The following [video](https://youtu.be/X0VIGZ_lExQ) shows a quick overview of an ISO installation. @@ -63,11 +67,7 @@ The following [video](https://youtu.be/X0VIGZ_lExQ) shows a quick overview of an ![config-password.png](/img/v1.2/install/config-password.png) -1. Choose the installation disk you want to install the Harvester cluster on and the data disk you want to store VM data on. By default, Harvester uses [GUID Partition Table (GPT)](https://en.wikipedia.org/wiki/GUID_Partition_Table) partitioning schema for both UEFI and BIOS. If you use the BIOS boot, then you will have the option to select [Master boot record (MBR)](https://en.wikipedia.org/wiki/Master_boot_record). - - :::info important - Support for legacy BIOS booting is deprecated in v1.7.0 and will be removed in a later release. Existing Harvester clusters that use this boot mode will continue to function, but upgrading to later versions may require re-installation in UEFI mode. To avoid issues and disruptions, use UEFI in new installations. - ::: +1. Choose the installation disk you want to install the Harvester cluster on and the data disk you want to store VM data on. ![choose-installation-target-data-disk.png](/img/v1.2/install/choose-installation-target-data-disk.png) diff --git a/docs/install/requirements.md b/docs/install/requirements.md index b0e450a1ee..dbad8d3090 100644 --- a/docs/install/requirements.md +++ b/docs/install/requirements.md @@ -34,7 +34,7 @@ Harvester nodes have the following hardware requirements and recommendations for :::info important -- Support for legacy BIOS booting is deprecated in v1.7.0 and will be removed in a later release. Existing Harvester clusters that use this boot mode will continue to function, but upgrading to later versions may require re-installation in UEFI mode. To avoid issues and disruptions, use UEFI in new installations. +- Support for legacy BIOS booting is deprecated in v1.7.0 and will be removed in a later release. Existing Harvester clusters that use this boot mode will continue to function, but upgrading to later versions may require re-installation in UEFI mode. Starting with Harvester v1.8.0, new installations are only possible on UEFI systems. - Mixed-architecture clusters are not supported. Deploy separate clusters to avoid unexpected system behavior. - For best results, use [YES-certified hardware](https://www.suse.com/yesCertified/home) for SUSE Linux Micro 6.1. Harvester is built on SUSE Linux Enterprise technology and YES-certified hardware has additional validation of driver and system board compatibility. Laptops and nested virtualization are not supported. - Nested virtualization is not supported on virtual machines running on Harvester.