git: 184a6af025 - main - handbook/bsdinstall: Suggest and reference virtualization

From: Joseph Mingrone <>
Date: Mon, 18 Mar 2024 13:32:20 UTC
The branch main has been updated by jrm:


commit 184a6af025571ff232d2c4153ddf17569ad78db5
Author:     Chris Moerz <>
AuthorDate: 2024-03-18 13:22:25 +0000
Commit:     Joseph Mingrone <>
CommitDate: 2024-03-18 13:24:31 +0000

    handbook/bsdinstall: Suggest and reference virtualization
    - Add a TIP pointing to virtualization
    - Add a reference to virtualization as alternative to changing
    PR:             263324
    Reviewed by:    jrm, Pau Amma <>
    Differential Revision:
 .../content/en/books/handbook/bsdinstall/_index.adoc          | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/documentation/content/en/books/handbook/bsdinstall/_index.adoc b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
index 0b02e5c6a6..9e4c5cf068 100644
--- a/documentation/content/en/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
@@ -82,7 +82,13 @@ The link:[FreeBSD download page] also has recommen
 == Pre-Installation Tasks
 Once it has been determined that the system meets the minimum hardware requirements for installing FreeBSD, the installation file should be downloaded and the installation media prepared.
-Before doing this, check that the system is ready for an installation by verifying the items in this checklist:
+Consider using crossref:virtualization[virtualization,virtualization] if you want to use FreeBSD on a system that already has another operating system installed.
+Before moving on to the installation, check that the system is ready by verifying the items in this checklist:
@@ -109,6 +115,8 @@ The FreeBSD boot loader requires either a primary or GPT partition.
 If all of the primary or GPT partitions are already in use, one must be freed for FreeBSD.
 To create a partition without deleting existing data, use a partition resizing tool to shrink an existing partition and create a new partition using the freed space.
+An alternative to modifying the system's existing disk partitions is to use crossref:virtualization[virtualization,virtualization], which allows multiple operating systems to run at the same time without having to alter partitions.
 A variety of free and commercial partition resizing tools are listed at link:[List of disk partitioning software wikipedia entry].
 link:[GParted Live] is a free live CD which includes the GParted partition editor.
@@ -119,7 +127,6 @@ Since the possibility of selecting the wrong partition exists, always backup any
 Disk partitions containing different operating systems make it possible to install multiple operating systems on one computer.
-An alternative is to use crossref:virtualization[virtualization,virtualization] which allows multiple operating systems to run at the same time without modifying any disk partitions.
 . *Collect Network Information*
 Some FreeBSD installation methods require a network connection in order to download the installation files.