From 10109abc9a282bcd5eb1f49bf8030e05e4d7d415 Mon Sep 17 00:00:00 2001 From: ericbsd Date: Fri, 18 Sep 2026 18:16:46 -0300 Subject: [PATCH 1/2] Document that GhostBSD and FreeBSD must not share a disk GhostBSD uses the FreeBSD UEFI loader. When both systems are installed on the same disk, that loader can boot the existing FreeBSD installation instead of GhostBSD, even when GhostBSD is selected in the firmware boot menu or in rEFInd. Add warnings to the installation guide and custom installation guide, a troubleshooting entry for the "selecting GhostBSD boots FreeBSD" symptom with recovery steps, and an FAQ entry pointing to both. The Polish translations receive the same additions. --- user/FAQ.md | 10 ++++++++++ user/installation-guide/custom-installation-pl.md | 8 ++++++++ user/installation-guide/custom-installation.md | 8 ++++++++ user/installation-guide/installation-guide-pl.md | 4 ++++ user/installation-guide/installation-guide.md | 4 ++++ user/installation-guide/troubleshooting-pl.md | 14 +++++++++++++- user/installation-guide/troubleshooting.md | 12 ++++++++++++ 7 files changed, 59 insertions(+), 1 deletion(-) diff --git a/user/FAQ.md b/user/FAQ.md index fb6cacc..e19250c 100644 --- a/user/FAQ.md +++ b/user/FAQ.md @@ -45,6 +45,16 @@ If you need to use an application only available on a specific operating system, If you migrate to GhostBSD from some other UNIX®-like environment, you already know most of what you need to know. However, if your background is in graphic-driven operating systems such as Microsoft Windows® and older versions of MacOS®, expect to invest additional time learning the UNIX way of doing things. +### Can I install GhostBSD and FreeBSD on the same disk? + +No. Do not install GhostBSD and FreeBSD on the same disk. + +They share the same UEFI boot loader. On one disk that loader can boot FreeBSD instead of GhostBSD, even if you choose rEFInd or pick GhostBSD in the firmware boot menu. + +Put GhostBSD on its own disk. Dual-boot with Windows or Linux on the same disk is supported. To run more than one GhostBSD version, use ZFS boot environments. + +See the [custom installation](installation-guide/custom-installation.md) and [troubleshooting](installation-guide/troubleshooting.md) guides. + ## Support ### What’s the best way to get support? diff --git a/user/installation-guide/custom-installation-pl.md b/user/installation-guide/custom-installation-pl.md index 66b543e..c9b8336 100644 --- a/user/installation-guide/custom-installation-pl.md +++ b/user/installation-guide/custom-installation-pl.md @@ -5,6 +5,14 @@ Instalacja niestandardowa i pełna instalacja dysku GhostBSD zaczynają się w t Celem tego przewodnika nie jest dostarczenie kroków dla każdej możliwej konfiguracji, ale zapewnienie pewnego kontekstu, który pomoże w niestandardowym partycjonowaniu i układach systemów plików. Sekcja [Instalacja GhostBSD](#installing-ghostbsd) zawiera kroki potrzebne do niestandardowej instalacji z zalecaną konfiguracją używającą UEFI, GPT i OpenZFS. +:::{warning} +Nie instaluj GhostBSD i FreeBSD na tym samym dysku. + +GhostBSD używa loadera UEFI FreeBSD. Gdy oba systemy są na jednym dysku, ten loader może uruchomić istniejącą instalację FreeBSD zamiast GhostBSD. Wybór rEFInd tego nie zmienia, ponieważ rEFInd i tak uruchamia ten sam loader. + +Zainstaluj GhostBSD na osobnym dysku. Dual-boot z Windows lub Linux na tym samym dysku jest obsługiwany. Aby zachować więcej niż jedną wersję GhostBSD, używaj środowisk startowych ZFS zamiast drugiej instalacji FreeBSD. +::: + ## Schematy partycjonowania W GhostBSD dostępne są dwa schematy partycjonowania, które są używane do dzielenia dysku na sekcje zwane slice’ami lub partycjami. Istnieje układ Master Boot Record (MBR) oraz układ GUID Partition Table (GPT). Ogólnie rzecz biorąc, dyski MBR są używane, jeśli maszyna uruchamia się z użyciem starszego systemu Basic Input/Output System (BIOS), natomiast dyski GPT są używane, gdy uruchamiana jest z nowszym Unified Extensible Firmware Interface (UEFI). UEFI może uruchamiać się z dysku GPT lub MBR, a w niektórych maszynach istnieje kod kompatybilności, który umożliwia BIOS-owi uruchamianie z dysków GPT, oprócz dysków MBR.[^1] diff --git a/user/installation-guide/custom-installation.md b/user/installation-guide/custom-installation.md index 04df24f..842db29 100644 --- a/user/installation-guide/custom-installation.md +++ b/user/installation-guide/custom-installation.md @@ -5,6 +5,14 @@ A custom installation and full disk installation of GhostBSD begin the same way. The purpose of this guide is not to provide the steps for every possible configuration, but to provide some background to help with custom partitioning and filesystem layouts. The [Installing GhostBSD](#installing-ghostbsd) section has the steps needed for a custom installation with the recommended setup using UEFI, GPT and OpenZFS. +:::{warning} +Do not install GhostBSD and FreeBSD on the same disk. + +GhostBSD uses the FreeBSD UEFI loader. When both operating systems share a disk, that loader can boot the existing FreeBSD installation instead of GhostBSD. Choosing rEFInd does not change this, because rEFInd still starts the same loader. + +Install GhostBSD on its own disk. Dual-boot with Windows or Linux on the same disk is supported. To keep more than one GhostBSD version, use ZFS boot environments rather than a second FreeBSD installation. +::: + ## Partitioning schemes There are two partitioning schemes available in GhostBSD that are used to divide a disk into sections called slices or partitions. There is the Master Boot Record (MBR) layout and the GUID Partition Table (GPT) layout. Generally, MBR disks are used if the machine boots with the legacy Basic Input/Output System (BIOS) and GPT disks are used when booting with the newer Unified Extensible Firmware Interface (UEFI). UEFI can boot from a GPT or MBR disk and in some machines there is compatibility code that allows BIOS to boot from GPT disks, in addition to, MBR disks.[^1] diff --git a/user/installation-guide/installation-guide-pl.md b/user/installation-guide/installation-guide-pl.md index 5c83500..23bc3d6 100644 --- a/user/installation-guide/installation-guide-pl.md +++ b/user/installation-guide/installation-guide-pl.md @@ -14,6 +14,10 @@ Po przeczytaniu tego przewodnika będziesz wiedział: * Jak zainstalować obok innego systemu operacyjnego. * Rozwiązywanie problemów z instalatorem i nośnikami live. +:::{warning} +Nie instaluj GhostBSD i FreeBSD na tym samym dysku. Korzystają z tego samego loadera UEFI, więc GhostBSD może uruchomić istniejącą instalację FreeBSD. Zainstaluj GhostBSD na osobnym dysku. Dual-boot z Windows lub Linux jest obsługiwany. +::: + ```{toctree} :caption: Spis treści diff --git a/user/installation-guide/installation-guide.md b/user/installation-guide/installation-guide.md index b0ce94f..7fe9910 100644 --- a/user/installation-guide/installation-guide.md +++ b/user/installation-guide/installation-guide.md @@ -14,6 +14,10 @@ After reading this guide, you will know: * How to install alongside other operating system(s). * Troubleshooting the installer and live media. +:::{warning} +Do not install GhostBSD and FreeBSD on the same disk. They share the same UEFI boot loader, so GhostBSD can boot the existing FreeBSD installation instead. Put GhostBSD on a separate disk. Dual-boot with Windows or Linux is supported. +::: + ```{toctree} :caption: Table of Contents diff --git a/user/installation-guide/troubleshooting-pl.md b/user/installation-guide/troubleshooting-pl.md index f69f577..d4a3c1c 100644 --- a/user/installation-guide/troubleshooting-pl.md +++ b/user/installation-guide/troubleshooting-pl.md @@ -19,4 +19,16 @@ Czasami pliki ISO mogą zostać uszkodzone podczas pobierania lub tworzenia boot Spróbuj stworzyć bootowalny USB za pomocą [najnowszego ISO](https://www.ghostbsd.org/download) dostępnego na stronie Pobierania w sekcji *Najnowsze wersje*. GhostBSD jest wersją rolling release i czasami aktualizacje i poprawki są wdrażane do najnowszej wersji przed utworzeniem nowego oficjalnego obrazu. -*Proszę zauważyć*: Ta sekcja jest niekompletna i obecnie jest aktualizowana. \ No newline at end of file +*Proszę zauważyć*: Ta sekcja jest niekompletna i obecnie jest aktualizowana. + +## Po instalacji wybór GhostBSD uruchamia FreeBSD. + +### GhostBSD i FreeBSD są zainstalowane na tym samym dysku. + +Nie instaluj GhostBSD i FreeBSD na tym samym dysku. + +W systemach UEFI korzystają one z tego samego loadera. Ten loader przeszukuje partycje na dysku startowym i może uruchomić istniejącą instalację FreeBSD nawet wtedy, gdy wybierzesz GhostBSD w menu oprogramowania układowego lub w rEFInd. + +Zainstaluj GhostBSD na osobnym dysku. Dual-boot z Windows lub Linux na tym samym dysku jest obsługiwany. + +Jeśli oba systemy są już na jednym dysku, uruchom komputer z pamięci USB GhostBSD live i pozostaw na tym dysku tylko jeden z nich albo przenieś GhostBSD na osobny dysk. diff --git a/user/installation-guide/troubleshooting.md b/user/installation-guide/troubleshooting.md index 1b502cb..322e98d 100644 --- a/user/installation-guide/troubleshooting.md +++ b/user/installation-guide/troubleshooting.md @@ -47,3 +47,15 @@ Users of affected Apple hardware may find it impossible to set the Mac to use a ### … Please note: this section is incomplete. + +## After installation, selecting GhostBSD boots FreeBSD. + +### GhostBSD and FreeBSD are installed on the same disk. + +Do not install GhostBSD and FreeBSD on the same disk. + +On UEFI systems they share the same boot loader. That loader searches partitions on the boot disk and can start the existing FreeBSD system even when you select GhostBSD in the firmware menu or in rEFInd. + +Install GhostBSD on a separate disk. Dual-boot with Windows or Linux on the same disk is supported. + +If both are already on one disk, boot from the GhostBSD live USB and keep only one of the two systems on that disk, or move GhostBSD to its own disk. From 84301f7b84ffdeccfaf2a05aad3e11894aba4d35 Mon Sep 17 00:00:00 2001 From: Eric Turgeon <4249848+ericbsd@users.noreply.github.com> Date: Fri, 18 Sep 2026 18:34:08 -0300 Subject: [PATCH 2/2] Update user/installation-guide/troubleshooting.md Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com> --- user/installation-guide/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user/installation-guide/troubleshooting.md b/user/installation-guide/troubleshooting.md index 322e98d..b8c77c9 100644 --- a/user/installation-guide/troubleshooting.md +++ b/user/installation-guide/troubleshooting.md @@ -58,4 +58,4 @@ On UEFI systems they share the same boot loader. That loader searches partitions Install GhostBSD on a separate disk. Dual-boot with Windows or Linux on the same disk is supported. -If both are already on one disk, boot from the GhostBSD live USB and keep only one of the two systems on that disk, or move GhostBSD to its own disk. +If both are already on one disk, boot from the GhostBSD live USB and back up all data from both installations to an external disk. Use `gpart show` and the partition labels and filesystems to identify the GhostBSD and FreeBSD partitions; mount candidate partitions read-only if necessary and verify their contents before making changes. Remove the FreeBSD installation by deleting only its partitions, or relocate one installation to another disk, while preserving the desired system and its data. Finally, use the GhostBSD installer to reinstall or repair the GhostBSD boot loader, then reboot and verify that GhostBSD starts.