https://<project-ref>.storage.supabase.co/storage/v1/s3.
Setup
Supabase signs S3 requests with an S3 access key, not the project’sanon or
service_role key.
- In the Supabase dashboard, open the project, then Storage > Settings, and turn on the S3 connection.
- Under S3 Access Keys, pick New access key.
- Copy the Access key ID and Secret access key. Supabase shows the secret only once.
- Copy the Region from the same page. Supabase needs one to sign requests.
- Copy the project reference from the dashboard URL:
https://supabase.com/dashboard/project/<project-ref>.
- An S3 access key reaches every bucket in the project and bypasses Row Level Security. Keep it on a server.
- Supabase requires path-style URLs; both SDKs use them by default.
Connect
- YAML
- Python
- TypeScript
workspace.yaml
Layout
- Each object key is a file path; folders are key prefixes, and the bucket holds no directory objects.
key_prefix(keyPrefixin TypeScript) mounts one subpath of the bucket as the root.grep -r,findanddustop after 1000 files; a glob matching more,tar -c,cp -randrm -rare refused.
Sample runs
write mount, redirects, cp, mv and rm 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.