Skip to main content
Every object in an existing Wasabi bucket becomes a file, and every / in a key becomes a folder.

Setup

Create an access key in the Wasabi console, then export it.
  1. Open Access Keys and click Create Access Key.
  2. Pick Root User or Sub-User. A sub-user whose policy covers only the bucket is the safer choice.
  3. Click Create, then copy or download the Access Key and Secret Key. The secret key cannot be shown again.
  4. Note the bucket’s region, for example us-east-2.
Each user holds at most two access keys.

Connect

workspace.yaml

Layout

  • The endpoint comes from region: s3.<region>.wasabisys.com, or s3.wasabisys.com for us-east-1, the default. endpoint_url (endpoint in TypeScript) overrides it.
  • key_prefix (keyPrefix in TypeScript) mounts one folder of the bucket as the root.
  • grep -r, find and du stop after 1000 files; a glob matching more, tar -c, cp -r and rm -r are refused.

Sample runs

On a write mount, cp, mv, rm and > change objects in the bucket. For write: conditional, see S3-compatible VFSes.

SDK guides

Python

Every config field, the VFS.md and write support.

TypeScript

Every config field, the VFS.md and write support.