Update fuse docs with FreeBSD specifics (#10820)
Closes #8846
Andrew Gillis committed
Jun 2, 2025 at 10:01 UTC
e491ee98e90925aeedd6debe1fb3da8e757732dc
1 file changed
+20
docs/fuse.md
+20
@@ -48,6 +48,21 @@ go get github.com/jbenet/go-fuse-version/fuse-version
48
If you run into any problems installing FUSE or mounting IPFS, hop on IRC and
49
speak with us, or if you figure something new out, please add to this document!
50
51
+#### FreeBSD
52
+```sh
53
+sudo pkg install fusefs-ext2
54
+```
55
+
56
+Load the fuse kernel module:
57
+```sh
58
+sudo kldload fusefs
59
+```
60
+
61
+To load automatically on boot:
62
+```sh
63
+sudo echo fusefs_load="YES" >> /boot/loader.conf
64
+```
65
+
66
## Prepare mountpoints
67
68
By default ipfs uses `/ipfs`, `/ipns` and `/mfs` directories for mounting, this can be
@@ -107,6 +122,11 @@ ipfs config --json Mounts.FuseAllowOther true
122
ipfs daemon --mount
123
```
124
125
+If using FreeBSD, it is necessary to run `ipfs` as root:
126
+```sh
127
+sudo HOME=$HOME ipfs daemon --mount
128
+```
129
+
130
## MFS mountpoint
131
132
Kubo v0.35.0 and later supports mounting the MFS (Mutable File System) root as