GhostBSD Installation Guide: Step-by-Step

This guide walks you through installing GhostBSD, a user-friendly desktop operating system based on FreeBSD, from downloading the ISO to booting into your new system. You will learn the minimum requirements, how to create a bootable USB drive, the step-by-step installer process, and how to handle common post-installation issues.

What Is GhostBSD and Why Install It?

GhostBSD is a free, open-source operating system that combines the stability and security of FreeBSD with a pre-configured desktop environment (MATE or XFCE). It is designed for users who want a FreeBSD foundation without having to manually configure the system from the command line. Unlike Linux distributions, GhostBSD uses the FreeBSD kernel and userland, which means it inherits FreeBSD’s robust networking stack, ZFS file system support, and the pkg package manager. Typical users include developers, system administrators, and hobbyists who want a Unix-like system that feels familiar to macOS or Linux.

Before You Start: Requirements and Preparation

Before you begin, check that your hardware meets the minimum requirements. GhostBSD runs on 64-bit (amd64) systems only; there is no official 32-bit (i386) build. You will need:

At least 4 GB of RAM (8 GB recommended for comfortable desktop use)
At least 20 GB of free disk space (more if you plan to use ZFS snapshots)
A USB drive of at least 2 GB (8 GB or larger is easier to work with)
An internet connection – not required for installation, but needed to install additional software

GhostBSD supports both UEFI and legacy BIOS boot modes. If your computer uses UEFI (most modern PCs), you should enable UEFI boot in your firmware settings and disable Secure Boot, as GhostBSD does not yet support it. Also, back up any important data on the target machine, because the installer will modify the disk.

Downloading the ISO and Creating a Bootable USB

First, download the latest GhostBSD ISO from the official website (ghostbsd.org). Choose the edition that matches your preferred desktop: MATE is the default and more polished, while XFCE is lighter and better for older hardware. After downloading, verify the SHA-256 checksum if you want to ensure file integrity; the checksum is listed on the download page.

To create a bootable USB drive, you can use tools like dd on Linux/macOS or Rufus (in DD mode) on Windows. On Linux, for example, you would run:

sudo dd if=GhostBSD.iso of=/dev/sdX bs=4M status=progress

Replace /dev/sdX with your USB device (be very careful to use the correct disk). On Windows, Rufus with “DD image mode” works reliably. Once written, insert the USB drive into the target computer and boot from it – usually by pressing a key like F12, F2, or Esc during startup to select the boot device.

The Installation Process Step by Step

When the USB boots, you will see a menu. Choose “Boot GhostBSD” (or the default option) and wait for the live desktop to load. Then double-click the “Install GhostBSD” icon on the desktop. The installer is a graphical wizard called gbi (GhostBSD installer). Follow these steps:

Choose a language – select your preferred language for the installer.
Select your keymap – usually the default for your keyboard layout is fine.
Set the hostname – give your computer a name (e.g., myghost).
Choose the installation type – you can install to an entire disk (erasing it) or use a custom partition scheme. For most users, “Erase disk and install GhostBSD” is simplest.
Select the target disk – be careful to choose the correct disk; the installer will show the size and model.
Choose a file system – your options are ZFS (recommended, offers snapshots and checksums) or UFS (simpler, traditional). ZFS is the default and works well for desktops.
Set the root password – this is the system administrator password. Make it strong.
Create a user account – you will enter your full name, username, password, and select the groups. The installer typically adds the user to the wheel group (for sudo access) and operator group.
Review and confirm – the installer shows a summary. Click “Install” and wait for the process to complete. This can take 5–15 minutes depending on your disk speed.

Once finished, you will be prompted to reboot. Remove the USB drive and boot into your new GhostBSD system.

First Boot and Post-Installation Setup

After rebooting, you will see the login screen. Log in with the user account you created. The first thing you should do is update the system and install any missing drivers or software. Open a terminal and run:

sudo pkg update && sudo pkg upgrade

This updates the package repository and upgrades all installed packages. If you have a NVIDIA graphics card, you may want to install the appropriate driver (e.g., nvidia-driver) and enable it in /etc/rc.conf. For most other hardware, the default free drivers work out of the box.

You may also want to install additional software from the package repository using sudo pkg install. For example, to install Firefox, run sudo pkg install firefox. GhostBSD also provides a graphical software manager called Software Station that you can use instead of the command line.

Common Problems and How to Solve Them

Here are a few issues you might encounter and their typical fixes:

Boot hangs at a black screen – This often happens with NVIDIA graphics. At the boot menu, select “Boot GhostBSD with ACPI disabled” or add kern.vty=vt to the boot options. If that works, install the NVIDIA driver after booting.
Wi-Fi not working – Some wireless chipsets (especially Intel and Realtek) require firmware that may not be included by default. Install the freebsd-firmware package or the specific driver package for your chipset (e.g., iwm-firmware for Intel).
Can’t mount NTFS/exFAT drives – Install the fusefs-ntfs and fusefs-exfat packages to read and write Windows partitions.
Audio has no sound – Run sudo sysctl hw.snd.default_unit=0 after installing the snd-dummy driver, or use the mixer to select the correct output device.

If you run into a problem not listed here, the GhostBSD forums and FreeBSD handbook are excellent resources.

GhostBSD vs. FreeBSD vs. Linux

If you are coming from Linux, GhostBSD will feel similar but with some differences. The package manager is pkg instead of apt or dnf, and the init system is rc rather than systemd. The file system layout is the same as FreeBSD, with /usr/local for installed software. Compared to vanilla FreeBSD, GhostBSD gives you a pre-installed desktop, graphical installer, and a set of default drivers, so you can start using it right away without editing configuration files. It is not a Linux distribution; it is a BSD system, so some commands and paths differ (e.g., ifconfig instead of ip).

Frequently Asked Questions

Can I dual-boot GhostBSD with Windows or Linux?

Yes, but the installer does not automatically resize existing partitions. You must shrink your Windows or Linux partition beforehand using that system’s disk management tool, then install GhostBSD into the free space. During the GhostBSD installer, choose “Manual” partitioning and create a new partition in the free space. After installation, you may need to configure your boot manager (e.g., rEFInd or GRUB) to see GhostBSD.

Is GhostBSD free to use?

Yes, GhostBSD is completely free and open-source. You can download, use, and redistribute it without cost. It does not collect personal data or require registration.

How do I install software after the system is set up?

You can use the command line with sudo pkg install or use the graphical “Software Station” application. To search for a package, use pkg search . For example, to find LibreOffice, run pkg search libreoffice.

Does GhostBSD support gaming?

Gaming on GhostBSD is possible but limited compared to Windows or even Linux. Steam has a FreeBSD version, but many games rely on Linux-specific libraries. You can try using the Linux compatibility layer (linuxulator) to run some Linux games, but performance and compatibility vary. For most AAA games, you will need a dual-boot or a different OS.

How often is GhostBSD updated?

GhostBSD follows a rolling release model, meaning you get continuous updates rather than major version upgrades. The base system is updated from FreeBSD stable branches, and packages are updated regularly. You can update your system with sudo pkg upgrade and the base system with sudo freebsd-update fetch install (though GhostBSD usually handles this automatically).

Can I use GhostBSD on a Raspberry Pi or ARM device?

As of now, GhostBSD only provides official builds for 64-bit x86 systems. There is no official ARM image, so you cannot install it on a Raspberry Pi. If you want a BSD on ARM, you could try FreeBSD directly, but it will not have the GhostBSD desktop pre-configured.

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →