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

Setup

Create a Spaces access key in the DigitalOcean control panel, then export it.
  1. Click Spaces Object Storage in the left menu, open the Access Keys tab and click Create Access Key.
  2. Pick Limited Access and grant the Space Read, or Read/Write/Delete for a write mount. Full Access reaches every Space.
  3. Name and create the key, then copy the Access Key ID and Secret Key. The secret key is shown only once.
  4. Note the Space’s name (the bucket) and its region, for example nyc3.

Connect

workspace.yaml

Layout

  • The endpoint comes from region: <region>.digitaloceanspaces.com. 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.