Skip to main content
The SeaweedFS VFS is a thin wrapper over the S3 VFS. It maps a SeaweedFSConfig to an S3Config and reuses the exact same backend, commands, and behavior as S3, it just points at your SeaweedFS S3 gateway endpoint_url and uses path-style addressing by default. SeaweedFS exposes an S3-compatible gateway (default port 8333), so endpoint_url is required (there is no region-derived host). Uses aioboto3 against the SeaweedFS S3 API.

Config

Both READ and WRITE modes are supported.

Example

Notes

  • SeaweedFS reports VFSName.S3 and routes through the same core/s3 implementation, so the full S3 shell-command set applies (ls, cat, head, tail, grep, rg, wc, find, tree, jq, stat). See the S3 VFS for the complete command reference, range reads, streaming, and the index cache fast path.
  • Blaxel Agent Drive is backed by SeaweedFS. To mount a drive’s S3 gateway, point endpoint_url at the drive’s s3Url and supply credentials for it.
  • For credential setup, see SeaweedFS Setup.