s3store

README

togo-framework/storage-s3

Part of the togo framework.

Install

togo install togo-framework/storage-s3

storage-s3

An AWS S3 driver for togo storage. Implements togo.Storage and overrides the default filesystem storage when installed — your app keeps using k.Storage.Put/Get/Delete/Path, now backed by S3.

Install

togo install togo-framework/storage-s3

Configure (.env)

S3_BUCKET=my-bucket
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=…
AWS_SECRET_ACCESS_KEY=…

Any default AWS credential source works (env vars, shared config, IAM role). If S3_BUCKET is unset the plugin no-ops and the default storage stays active.

How it works

Blank-importing the package registers an S3-backed togo.Storage provider at PriorityService+10, so it overrides the built-in filesystem store. Path() returns the public object URL.

MIT © togo-framework

---

Premium sponsors

ID8 Media  ·  One Studio

_{Support togo — become a sponsor.}

Documentation

Overview

Package s3store is an AWS S3 driver for togo storage. It implements togo.Storage and overrides the default filesystem storage when installed. Blank-import + set S3_BUCKET (and the standard AWS_* credentials/region).

togo install togo-framework/storage-s3

Env: S3_BUCKET (required), AWS_REGION (default us-east-1), AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY (or any default AWS credential source).