From e491ee98e90925aeedd6debe1fb3da8e757732dc Mon Sep 17 00:00:00 2001
From: Andrew Gillis <11790789+gammazero@users.noreply.github.com>
Date: Mon, 2 Jun 2025 10:01:26 -0700
Subject: [PATCH] Update fuse docs with FreeBSD specifics (#10820)

Closes #8846
---
 docs/fuse.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/fuse.md b/docs/fuse.md
index fde9307fd..b928b8860 100644
--- a/docs/fuse.md
+++ b/docs/fuse.md
@@ -48,6 +48,21 @@ go get github.com/jbenet/go-fuse-version/fuse-version
 If you run into any problems installing FUSE or mounting IPFS, hop on IRC and
 speak with us, or if you figure something new out, please add to this document!
 
+#### FreeBSD
+```sh
+sudo pkg install fusefs-ext2
+```
+
+Load the fuse kernel module:
+```sh
+sudo kldload fusefs
+```
+
+To load automatically on boot:
+```sh
+sudo echo fusefs_load="YES" >> /boot/loader.conf
+```
+
 ## Prepare mountpoints
 
 By default ipfs uses `/ipfs`, `/ipns` and `/mfs` directories for mounting, this can be
@@ -107,6 +122,11 @@ ipfs config --json Mounts.FuseAllowOther true
 ipfs daemon --mount
 ```
 
+If using FreeBSD, it is necessary to run `ipfs` as root:
+```sh
+sudo HOME=$HOME ipfs daemon --mount
+```
+
 ## MFS mountpoint
 
 Kubo v0.35.0 and later supports mounting the MFS (Mutable File System) root as