kb/fwupd.md: add instructions for FreeBSD

It works, but not without issues.  More work will be necessary to make
it fully useable.

Signed-off-by: Sergii Dmytruk <sergii.dmytruk@3mdeb.com>

Author: SergiiDmytruk

docs/kb/fwupd.md

@@ -182,9 +182,42 @@ it to perform firmware updates.
         ```
     </details>
 
+=== "FreeBSD"
+
+    !!! warning
+        `fwupd` on FreeBSD is very much work in progress as of March 2026.  The
+        basic elements are there, but user experience may be far from perfect.
+        In particular, not all functionality is available (e.g., `fwupd` won't
+        reboot for you, update is reported as "in progress" after it's been
+        applied) or works reliably (may complain about missing ESP, although
+        this error may be gone on second try or after restarting `fwupd`).
+
+    `fwupd` is available in ports.  `bsdisks` is a dependency required for
+    UEFI Capsule Updates.  Install both of them:
+
+    ```terminal
+    # pkg install fwupd bsdisks
+    ```
+
+    `fwupd` communicates with `bsdisks` over D-Bus, so it must be running
+    (`fwupdmgr` also depends on D-Bus, otherwise using `fwupdtool` as root is
+    the only option).  It can be enabled permanently and then launched like
+    this:
+
+    ```terminal
+    # echo 'dbus_enable="YES"' >> /etc/rc.conf
+    # service dbus start
+    ```
+
+    This is how to start D-Bus temporarily:
+
+    ```terminal
+    # service dbus onestart
+    ```
+
 ### Checking the current firmware version
 
-=== "Ubuntu, Fedora"
+=== "Ubuntu, Fedora, FreeBSD"
     To check the currently used firmware version, run the following command
 
     ```bash
@@ -260,7 +293,7 @@ it to perform firmware updates.
 
 ### Checking for updates
 
-=== "Ubuntu, Fedora"
+=== "Ubuntu, Fedora, FreeBSD"
     To check for available updates for your device, run the following commands
 
     ```bash
@@ -402,6 +435,40 @@ are met.
         and the updates on LVFS may not be found using this tool. Refer to
         [troubleshooting](#no-updates-available-qubesos).
 
+=== "FreeBSD"
+    To update your firmware, run the following commands:
+
+    ```terminal
+    # fwupdmgr refresh
+    # fwupdmgr update --no-reboot-check
+    # reboot
+    ```
+
+    <details><summary>Example of an update process:</summary>
+        ```
+        # fwupdmgr update --no-reboot-check
+        Devices with no available firmware updates:
+        • UEFI dbx
+        • SSDPR-PX600-250-80
+        ╔══════════════════════════════════════════════════════════════════════════════╗
+        ║ Upgrade System Firmware from 1.0.0 to 1.0.1?                                 ║
+        ╠══════════════════════════════════════════════════════════════════════════════╣
+        ║ New Dasharo firmware release for the NovaCustom Meteor Lake laptops          ║
+        ║                                                                              ║
+        ║ with integrated graphics, featuring numerous bug fixes, performance          ║
+        ║                                                                              ║
+        ║ improvements and stability fixes.                                            ║
+        ║                                                                              ║
+        ║ V54x_6x_TU must remain plugged into a power source for the duration of the   ║
+        ║ update to avoid damage.                                                      ║
+        ╚══════════════════════════════════════════════════════════════════════════════╝
+        Perform operation? [Y|n]: y
+        Waiting…                 [***************************************]
+        Successfully installed firmware
+        Do not turn off your computer or remove the AC adapter while the update is in progress.
+        ```
+    </details>
+
 !!! warning
     After the command finishes, a reboot is necessary to apply the update.
     The fwupd UEFI application that performs the update will be booted
@@ -438,6 +505,23 @@ source. We will use `novacustom_v54x_mtl_igpu_v1.0.1_btg_prod.cab` downloaded fr
         $ sudo fwupdmgr local-install novacustom_v54x_mtl_igpu_v1.0.1_btg_prod.cab
         ```
 
+=== "FreeBSD"
+    To update your firmware using a locally available cabinet file, follow the
+    steps:
+
+    1. Allow updates from untrusted sources
+        ```terminal
+        # printf '[fwupd]\nOnlyTrusted=false\n' > /usr/local/etc/fwupd/fwupd.conf
+        ```
+    2. Perform a local install
+        ```terminal
+        # fwupdmgr local-install --no-reboot-check novacustom_v54x_mtl_igpu_v1.0.1_btg_prod.cab
+        ```
+    3. Reboot to apply the update
+        ```terminal
+        # reboot
+        ```
+
 #### Update troubleshooting
 
 ##### No output from fwupdmgr update
@@ -607,6 +691,17 @@ manually from fwupd.org.
     `qubes-fwupdmgr` doesn't currently support `get-results` command of
     `fwupdmgr`.
 
+=== "FreeBSD"
+    The following command is supposed to report update results:
+
+    ```bash
+    $ fwupdmgr get-results
+    ```
+
+    However, this is likely to not produce any results because fwupd fails to
+    finalize the update.  `fwupdmgr get-devices` incorrectly states that "An
+    update is in progress" along with displaying version that shows the update
+    has already happened.
 
 For another way to verify an update has really happened refer to
 [Checking The Current Firmware Version](#checking-the-current-firmware-version).