S3 Storage Plugin - Eliza

The S3 Storage plugin enables Eliza agents to store and retrieve files, media, and generated artifacts using any S3-compatible object storage service.

Package: @elizaos/plugin-s3-storage

Overview

This plugin provides an S3-backed storage layer for agent-generated content. It works with AWS S3 as well as S3-compatible services like MinIO, DigitalOcean Spaces, Cloudflare R2, and Backblaze B2.

Installation

bash

eliza plugins install s3-storage

Auto-Enable

Auto-enables when S3_ACCESS_KEY_ID is set.

Configuration

Environment Variable	Required	Description
`S3_ACCESS_KEY_ID`	Yes	AWS access key ID (sensitive)
`S3_SECRET_ACCESS_KEY`	Yes	AWS secret access key (sensitive)
`S3_BUCKET`	Yes	Target S3 bucket name
`S3_REGION`	No	AWS region (default: `us-east-1`)
`S3_ENDPOINT`	No	Custom endpoint for S3-compatible services

Example: MinIO

bash

export S3_ACCESS_KEY_ID=minioadmin
export S3_SECRET_ACCESS_KEY=minioadmin
export S3_BUCKET=eliza-storage
export S3_ENDPOINT=http://localhost:9000

Example: AWS S3

bash

export S3_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export S3_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export S3_BUCKET=my-eliza-bucket
export S3_REGION=us-west-2