Introduction

Welcome, intrepid hacker and Unix enthusiast! You’ve probably tried every flavor of Linux under the sun, but now you’re ready to explore the mysterious world of DragonFly BSD. Far from being a “Linux distro,” DragonFly BSD is an independent descendant of FreeBSD—rearchitected for performance, scalability, and reliability. Its namesake evokes mythical beasts, but the only dragons here breathe HAMMER filesystem snapshots, not fire.

In this guide you’ll find everything from download to post-install tweaking. We’ll sprinkle in a dash of humor so your journey into BSDdom isn’t quite as dry as a man page. Let’s dive in!

System Requirements

• CPU: 64-bit x86_64 (Intel or AMD). ARM and other ports exist, but x86_64 is most common.
• RAM: Minimum 1 GB, but 2 GB recommended for smooth operations and compiling from source.
• Disk: At least 10 GB of free space (20 GB if you plan to build kernels or run VMs).
• Network: Ethernet or Wi-Fi adapter supported by the BSD drivers. (Most Intel NICs “just work.”)
• Archival media: USB stick (4 GB ) or a blank DVD.

Step 1: Downloading DragonFly BSD

1. Visit the official site:
   https://www.dragonflybsd.org/
2. Go to the Download section. Choose the latest ISO for amd64.
3. Optionally, verify the .sig file with gpg --verify to prove you’re not downloading a mythical impostor.

Step 2: Creating Bootable Media

On Linux

Use dd to write the ISO. Be very careful with /dev/sdX!

dd if=DragonFly-.iso of=/dev/sdX bs=1M conv=sync status=progress
  

On Windows

• Download Rufus.
• Select the ISO, target USB device, and choose “DD image mode.”

On macOS

1. Find your USB with diskutil list.
2. Unmount it: diskutil unmountDisk /dev/diskN.
3. Use dd: sudo dd if=DragonFly-.iso of=/dev/rdiskN bs=1m.

Step 3: Booting the Installer

• Insert your USB/DVD and reboot.
• Enter your BIOS/UEFI Boot Menu (often F12, F10 or Esc).
• Select your media. You should see the DragonFly boot menu.

If you feel lost, remember: pressing Enter selects defaults (a fine choice for newbies).

Step 4: Disk Partitioning

DragonFly uses the classic BSD disklabel system on top of an MBR/GPT container. We recommend a GPT layout with a small EFI System Partition and a main partition for DragonFly.

1. At the prompt, run bsdinstall disklabel.
2. Select your disk (e.g., ada0 or nvd0).
3. Create an EFI partition (~200 MB, type efi) and mark it bootable.
4. Create a DragonFly partition for swap (size = your RAM) and another for root (/).
5. Optionally, carve out /usr, /var or /home as separate partitions for neatness.
6. Write the labels and exit.

Step 5: Installing the Base System

Back at the main bsdinstall menu, choose Install. The installer will walk you through:

• Setting your time zone (select your continent and country).
• Choosing your keymap (default is US).
• Creating a root password (don’t make it dragon!).
• Adding a regular user account.

Once confirmed, the installer will copy files. Grab coffee, recite your favorite BSD haiku, or dance until it finishes.

Step 6: Bootloader Configuration

The installer uses loader(8) in EFI mode. You’ll get a simple text menu at boot. No flashy splash screens here—that’s UNIX minimalism for you.

Step 7: First Boot Networking

1. Reboot and remove the installation media.
2. At the DragonFly prompt, log in as root (or your new user).
3. Check network status: ifconfig for Ethernet, wifimgr for Wi-Fi.
4. DHCP usually “just works.” For static IP, edit /etc/rc.conf:

ifconfig_em0=inet 192.168.1.10 netmask 255.255.255.0
defaultrouter=192.168.1.1
  

Step 8: System Update Package Management

Updating the Base System

1. Use the bootstrap utility:

   pkg bootstrap

2. Fetch updates:

   pkg update  pkg upgrade

Using dports pkg

DragonFly’s package system, pkg, draws from the dports repository. Install software like so:

pkg install vim git htop

Building from Source

If you crave performance tuning, compile from source:

1. Fetch the source tree:

   git clone https://git.dragonflybsd.org/dragonfly.git /usr/src

2. Build a world:

   cd /usr/src
   make buildworld
   make buildkernel
   make installkernel
   make installworld
   reboot
         

Step 9: Enabling HAMMER2 Filesystem

HAMMER2 is DragonFly’s advanced filesystem. To initialize:

hammer2 init -B local /dev/ada0p3
mount -t hammer2 /dev/ada0p3 /mnt
  

Move your data onto it, adjust /etc/fstab, and enjoy snapshots and replication.

Tips and Tricks

• Sysctl tweaks: tune vfs.hammer2.debug for performance data.
• Kernel modules: load additional drivers in /boot/loader.conf.
• SSH: enable in /etc/rc.conf with sshd_enable=YES.
• Firewall: experiment with ipfw or pf.
• Desktop: install Xorg and a window manager: pkg install xorg xfce.

Common Issues and Solutions

Conclusion

Congratulations! You’ve tamed the DragonFly BSD beast. You now possess a lean, mean, Unix machine with cutting-edge filesystem features and rock-solid heritage. Whether you’re building a server, desktop, or dev‐workhorse, DragonFly BSD delivers performance and reliability that’ll make your Linux installs green with envy.

For more adventures, dive into the official handbook at
DragonFly Handbook. Fly safely, and may your kernel never panic!