Reference
crab mount
Mount a Crab repository as a FUSE filesystem. Files are resolved on demand, so you can browse a large repository without hydrating everything first.
Synopsis
crab mount [SUBCOMMAND] [OPTIONS]
crab unmount [OPTIONS]Mount Options
| Option | Description |
|---|---|
--repo, -r <source> | Remote URL or local repository path. |
--mountpoint, -m <path> | Local mount path. |
--name <name> | Human-friendly mount name. |
--ref <branch> | Branch or ref to mount. |
--foreground | Run in the foreground. |
--read-only | Disable overlay writes. |
--no-refresh | Disable automatic remote polling. |
--allow-nested | Allow mounting inside a Git or Crab working tree. |
--clean-overlay | Discard existing overlay changes before mounting. |
Management Subcommands
| Command | Purpose |
|---|---|
crab mount list [--json] | List active mounts. |
crab mount status -m <path> [--verbose] [--json] | Report mount and hydration state. |
crab mount refresh -m <path> | Fetch and rebuild the mounted snapshot. |
crab mount switch -m <path> --ref <branch> | Switch a mount to another branch or ref. |
crab mount clean [--all] | Remove inactive mount caches. |
crab unmount -m <path> | Unmount one filesystem. |
crab unmount --all | Unmount all active Crab mounts. |
Examples
crab mount --repo crab://bucket/ml-models --mountpoint /mnt/models
crab mount --repo ./my-repo --mountpoint /tmp/view --ref dev
crab mount status --mountpoint /mnt/models --json
crab mount switch --mountpoint /tmp/view --ref main
crab unmount --mountpoint /mnt/modelsFor workflow guidance, see FUSE Mount and Mount Management.