Mount as a drive (WebDAV)

bb webdav serves your vault as a local WebDAV server. Every read decrypts on your machine and, with --read-write, every write is encrypted before upload. It works with Finder, rclone, Cyberduck and WinSCP.

bb webdav

It listens on 127.0.0.1 port 7878 unless you choose another port:

bb webdav --port 8081

What it does by default

• Read-only. Pass --read-write to allow uploads, deletes and renames (PUT, DELETE, MKCOL, MOVE).
• Local only. It binds to 127.0.0.1. Requests with a foreign Host or any Origin header are refused.
• A password per run. At startup it prints a random password. Every client must send it with HTTP Basic. The user name can be anything.

bb webdav --read-write --port 8081

Options

Flag	What it does
--port <port>	TCP port to listen on. Default 7878.
--read-write	Allow writes. Without it the gateway is read-only.
--cache-ttl <seconds>	Directory listing cache TTL. Default 30. 0 disables it.
--no-cache	Disable the path cache entirely. Useful for debugging.
--verbose	Log every request. The default is compact activity counters.

Windows

Windows Explorer’s “Map network drive” is not supported: it refuses HTTP Basic over plain HTTP by default. On Windows use the Beebeeb desktop app, rclone, Cyberduck or WinSCP.

Why not bb mount?

bb mount is a FUSE mount. Release binaries are built without FUSE, so on a downloaded bb it only prints setup guidance. bb webdav works on every released build.