@activefs/mount

WebDAV and rclone mount lifecycle helpers for exposing ActiveFS through a local mounted folder.

Use this package when you need the local mount adapter pieces directly. End users normally use the activefs CLI, which wraps these helpers.

Install

npm install @activefs/mount @activefs/core

Requires Node.js 20 or newer. Actual OS mounts also require rclone and a host mount backend such as macFUSE, FUSE, or WinFsp.

Small Example

import { createActiveFS, fsTree, text } from "@activefs/core";
import { startWebDAVServer } from "@activefs/mount";

const tree = fsTree({
  "/hello.txt": text("hello through WebDAV\n")
});

const activefs = createActiveFS().mount("/", tree);

const server = await startWebDAVServer({
  filesystem: activefs,
  rootPath: "/",
  auth: false
});

try {
  console.log(server.url);
} finally {
  await server.close();
}

What It Owns

• WebDAV request handling over ActiveFS.
• Loopback WebDAV server startup.
• rclone command construction and mount lifecycle helpers.
• Host mount diagnostics and mount-status helpers.

WebDAV/rclone is the current local mount adapter. It is not the Source API protocol and does not imply full native filesystem semantics on every host.

Docs

• Mounted folder: https://github.com/ankitparasher/activefs/blob/main/docs/guides/mounted-folder.md
• Supported environments: https://github.com/ankitparasher/activefs/blob/main/docs/reference/supported-environments.md
• CLI mount commands: https://github.com/ankitparasher/activefs/blob/main/docs/reference/cli.md