> ## Documentation Index
> Fetch the complete documentation index at: https://payload-storage-bunny.seshuk.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Store and serve Payload media on Bunny.net Storage and Stream, delivered from the global Bunny CDN.

`@seshuk/payload-storage-bunny` stores and serves your Payload media on [bunny.net](https://bunny.net?ref=fndfoymy0j). It wraps `@payloadcms/plugin-cloud-storage`, so uploads from your collections go straight to Bunny Storage and Stream and are delivered from Bunny's global CDN — wired into the admin panel with no extra glue.

## Key features

* **Bunny Storage** — images, documents, and any non-video file.
* **Bunny Stream** — videos and audio with adaptive HLS/MP4 playback, thumbnails, and TUS resumable uploads.
* **Client uploads** — send file bytes straight from the browser to Bunny, bypassing serverless body-size limits.
* **Signed URLs** — time-limited, geo-restricted access to files and videos.
* **Cache purging** — invalidate the CDN automatically on upload and delete.
* **Collection overrides** — keep one set of plugin options and tune every option per collection.

## Requirements

Payload 4 and Node.js 24.15 or later.

For Payload 3, use v3 of the plugin. See the [upgrade guide](/v4/upgrade-guide#v3-to-v4) to move from v3 to v4.

## Where to go next

<Columns cols={2}>
  <Card title="Setup wizard" icon="wand-magic-sparkles" href="/v4/cli/init">
    Run one command — it provisions your Bunny resources and prints ready-to-paste options.
  </Card>

  <Card title="Quick start" icon="rocket" href="/v4/quick-start">
    Install the plugin and point a collection at Bunny.
  </Card>

  <Card title="Configuration" icon="sliders" href="/v4/configuration/overview">
    Every option explained, from API keys to per-collection overrides.
  </Card>

  <Card title="Stream" icon="video" href="/v4/configuration/stream/overview">
    Serve video with HLS, MP4 fallback, and resumable TUS uploads.
  </Card>

  <Card title="Storage" icon="database" href="/v4/configuration/storage/overview">
    Store images and documents, delivered fast from the Bunny CDN.
  </Card>

  <Card title="Upgrade guide" icon="arrows-rotate" href="/v4/upgrade-guide">
    Upgrade between major plugin versions — option changes and the stored-data migration.
  </Card>

  <Card title="Examples" icon="code" href="/v4/guides/examples">
    Copy-ready options for common setups and real-world patterns.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.