docs: document -volumeName for the mount disk label

chris committed 2026-09-04 23:13:45 -07:00
1 parent c182f792fd
commit ae46aefc82
2 files changed
+27

No files matched your search

+10
@@ -203,6 +203,16 @@ mount -t weed fuse /mnt -o "filer='192.168.0.1:8888,192.168.0.2:8888',filer.path
Now you can operate the SeaweedFS files, browsing or modifying directories and files, in local file system.
To unmount, just shut it down the "weed mount".
#### Disk name (`-volumeName`)
Where the platform labels the mount — Finder on macOS, Explorer on Windows, and `mount`/`df` on Linux and FreeBSD — the name is derived from the mounted path: `-filer.path` first, then the `-dir` mount point, then the filer address. `-volumeName` overrides that derivation without changing what is mounted:
```bash
weed mount -filer=localhost:8888 -dir=/mnt/seaweedfs -filer.path=/ -volumeName=Photos
```
Leave `-volumeName` empty to keep the derived name. On Windows the override is the volume label Explorer shows; the UNC share name (e.g. `\\seaweedfs\Images`) is unaffected. See [[Mount on Windows]] for the Windows-specific details.
#### Mount with fstab
```
+17
@@ -38,9 +38,26 @@ Stop the mount with Ctrl-C, which unmounts cleanly and flushes pending writes. K
| `-readOnly` | Reject every modification at the WinFsp layer. |
| `-cacheMetaTtlSec` | How long WinFsp may cache attributes and directory entries. |
| `-debug.fuse` | Log every filesystem operation. |
| `-volumeName` | Name shown by Explorer for the disk, overriding the name taken from `-filer.path` or `-dir`. See [Disk name](#disk-name). |
Everything else — `-cacheDirForRead`, `-cacheSizeMBForRead`, `-chunkSizeLimitMB`, `-collection`, `-replication`, `-concurrentWriters` — behaves as it does elsewhere. See [[FUSE Mount]].
### Disk name
Explorer labels the mounted disk after the mounted path:
* `-filer.path=/Image Disk` shows up as `Image Disk`.
* Mounting the whole tree (`-filer.path=/`) takes the name from the mount point instead, so `-dir=\\seaweedfs\Images` labels the disk `Images` while still mounting everything.
* A bare drive letter (`-dir=S:`) has no name to take, so the disk falls back to the filer address.
The derived name can collide with the real drive it sits on, or with another mount's label. `-volumeName` overrides the derivation without changing what is mounted:
```powershell
weed.exe mount -filer=127.0.0.1:8888 -dir=\\seaweedfs\Images -volumeName=Photos
```
This mounts `\\seaweedfs\Images` as before but labels the disk `Photos`. The UNC share name (`\\seaweedfs\Images`) is unaffected — only the volume label changes. Leave `-volumeName` empty to keep the old behaviour. Commas in the value are replaced with `+`, since WinFsp treats commas as option separators.
#### Case sensitivity
The filer is case-sensitive, and so is the mount by default: `Report.txt` and `report.txt` are two files. Some Windows software assumes otherwise and will misbehave. `-windows.caseInsensitive` makes the mount match Windows expectations, at the cost of making one of any two names that differ only in case unreachable. WinFsp cannot do NTFS-style mixed sensitivity, so it is one or the other for the whole mount.