From 0f85c3576c9d949dab69af64b5c77b02e1773abb Mon Sep 17 00:00:00 2001
From: Ed Maste <emaste@FreeBSD.org>
Date: Thu, 28 May 2026 13:38:28 -0400
Subject: [PATCH] readme: Add FreeBSD instructions

It builds out-of-the-box with FreeBSD's built-in libusb.  I used
FreeBSD's built-in `mdo`, although sudo or doas would also work fine.
---
 Readme.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/Readme.md b/Readme.md
index 64765b8..82fa5e2 100644
--- a/Readme.md
+++ b/Readme.md
@@ -127,6 +127,22 @@ cd ..
 ```
 Running `make` again should now succeed.
 
+### FreeBSD
+1. Clone the `usbboot` repository
+2. Build using gmake. Installing to /usr/local is recommended.
+3. Run the binary
+
+```bash
+git clone --recurse-submodules --shallow-submodules --depth=1 https://github.com/raspberrypi/usbboot
+cd usbboot
+gmake INSTALL_PREFIX=/usr/local
+# Either
+mdo ./rpiboot -d mass-storage-gadget64
+# Or, install rpiboot to /usr/local/bin and boot images to /usr/local/share
+mdo gmake INSTALL_PREFIX=/usr/local install
+mdo rpiboot
+```
+
 ### Updating the rpi-eeprom submodule
 After updating the `usbboot` repo (`git pull --rebase origin master`), update the
 submodules by running: