Introduction

Welcome, intrepid explorer of the open-source universe! Today we embark on a quest to install NomadBSD,
that nimble BSD-based live system designed to run straight from USB sticks or hard drives. Despite its name,
it’s not Linux—but fear not: it shares much of the familiar UNIX spirit. Consider it a portable Swiss Army knife
for sysadmins, hackers, and wanderlust-driven road warriors.

In this guide you’ll find:

• An overview of NomadBSD’s features
• Preparation and system requirements
• Step-by-step download, verification, and USB creation
• Boot, installation (via Calamares), and post-install customization
• Troubleshooting tips and fun Easter eggs

About NomadBSD

NomadBSD is a live system based on FreeBSD. It aims to be:

• Portable: Run from USB without touching installed OS.
• Configurable: Persistent storage for home, tweaks, packages.
• User-friendly: Includes Calamares installer, graphical desktop (Xfce by default).
• Secure: FreeBSD’s stability, security, and ZFS support.

Visit the official project page:
https://nomadbsd.org

System Requirements

1. Downloading Verifying the ISO

1.1 Choose the Right ISO

• Standard ISO: Includes Xfce desktop, Calamares.
• Minimal ISO: Command-line only, for advanced users.

Grab the ISO from the mirrors:

https://sourceforge.net/projects/nomadbsd/files/

1.2 Checksum Verification

1. Download the corresponding .sha256 file.
2. On Linux/BSD/macOS terminal:

   sha256sum nomadbsd-1.6.2.img

3. Compare the output with the content of nomadbsd-1.6.2.sha256.

Why? Because corrupted ISOs are grumpy—and so is your USB stick after a bad write.

2. Creating a Bootable USB

2.1 Using dd (Linux/macOS/BSD)

sudo dd if=nomadbsd-1.6.2.img of=/dev/sdX bs=4M conv=fsync
  

• Replace /dev/sdX with your USB device (e.g., /dev/sdb).
• Double-check: mixing up letters can obliterate your main disk.

2.2 Using balenaEtcher (Cross-platform)

1. Download install from
   balenaEtcher.
2. Select your ISO, target USB, and hit “Flash.”
3. Enjoy the progress bar and soothing notifications.

3. Booting NomadBSD

• Insert USB, reboot, and enter BIOS/UEFI (usually F2, Del, F12).
• Select USB device boot menu appears.
• Choose “NomadBSD Live” (default) for a graphical session.

If you see a friendly Xfce desktop with the NomadBSD logo, you’ve succeeded! If you see an error, check
the FAQ or review Troubleshooting below.

4. Installing to Hard Drive

NomadBSD uses the Calamares installer for a smooth ride.

4.1 Launch Calamares

• On the desktop, click Install NomadBSD icon.
• Set language, timezone, keyboard layout.

4.2 Partitioning

You can choose Erase disk or Manual partitioning. For UEFI systems, recommended scheme:

4.3 User Setup

1. Create your user account (username/password).
2. Set root password (keep it secret, keep it safe).
3. Review settings and click Install.

The installer will copy files, configure the system, and (possibly) install a boot loader.
Kick back for a few minutes—grab a coffee, or pretend to do so, but definitely watch the progress bar.

5. First Boot Post-Install Tips

• Remove USB and reboot into your new NomadBSD system.
• Login with your created user.

5.1 Update the System

sudo freebsd-update fetch install
sudo pkg update  sudo pkg upgrade
  

5.2 Enable Services

For network, SSH, or other daemons, add to /etc/rc.conf:

sshd_enable=YES
dhcp_enable=YES    # if using DHCP
  

5.3 Customize Xfce

• Right-click panels to add/remove widgets.
• Set a custom wallpaper (Settings > Desktop).
• Install additional apps via Packages or pkg.

6. Persistence USB Mode

If running live from USB, you can configure persistence so that your changes survive reboots:

1. Edit /boot/loader.conf.local and add:

   vfs.root.mountfrom=geom::label/NOMADBSD

2. Label your USB root partition NOMADBSD.
3. Reboot changes (home, packages) now stick around.

7. Troubleshooting

7.1 Boot Hangs or Kernel Panics

• Add Safe Mode flags in the boot menu (press e at GRUB, append:

nomodeset noapic acpi=off

• Try UFS if ZFS causes issues, or vice versa.

7.2 Wi-Fi Not Working

• Ensure firmware files are in /usr/local/share/firmware.
• Use wpa_supplicant or NetworkManager.

7.3 Calamares Fails

• Switch to GParted live USB to pre-partition, then re-run installer.
• Check logs: /var/log/calamares.log

8. Advanced Topics Tips

8.1 ZFS Snapshots

sudo zfs snapshot zroot/ROOT@install
sudo zfs list -t snapshot
  

8.2 Virtualization

• Install bhyve, VirtualBox-OSE, or QEMU via pkg.
• Follow FreeBSD docs:
  
  FreeBSD Virtualization Handbook
  

Conclusion

You’ve now mastered the art of deploying NomadBSD! Whether you’re carrying your toolkit in a pocket-sized USB or running
a lean FreeBSD desktop, you’re ready to surf, code, and sysadmin with style—and a pinch of humor. Stay curious, stay adventurous,
and may your filesystems never corrupt.

Happy nomading!