S3

File System

Mount an S3-compatible bucket as a filesystem. File contents are chunked into S3 objects, keeping large files, partial reads/writes, and snapshots efficient.

Configuration

Built into the SDK — no separate install. Enable it with plugin: { id: "s3" } in your VM config.

import { agentOS, setup } from "@rivet-dev/agentos";
import pi from "@agentos-software/pi";
 
const vm = agentOS({
  software: [pi],
  mounts: [
    {
      path: "/home/agentos/data",
      plugin: {
        id: "s3",
        config: { bucket: "my-bucket", prefix: "agent-data/", region: "us-east-1" },
      },
    },
  ],
});
 
export const registry = setup({ use: { vm } });

View documentation