Skip to content

Bucket Storage

Bucket storage provides scalable object storage for files and binary data in Raindrop applications. Instead of storing files in databases or managing complex file systems, bucket storage offers a simple key-value approach for any type of content.

What Bucket Storage Provides

Object-Based Storage Every piece of data gets a unique key and can be retrieved instantly without navigating directory structures.

Scalable Performance Handles everything from small configuration files to large media files with automatic distribution and redundancy.

Flexible Data Types Store any content type - images, videos, documents, JSON files, or binary data without schema restrictions.

HTTP Integration Built-in support for web-friendly features like content types, caching headers, and range requests for streaming.

When to Use Bucket Storage

Good Fit

  • User Uploads: Profile photos, documents, media files
  • Application Assets: Static files, generated reports, cached data
  • Content Delivery: Images, videos, downloadable files that need global access
  • Binary Data: Any data that doesn’t fit well in structured databases

Consider Alternatives

  • Structured Data: User profiles, transactions, and relational data belong in SQL databases
  • High-Frequency Updates: Frequently modified shared data works better in databases or KV storage
  • Complex Queries: If you need to search across file contents, consider SmartBuckets instead

Integration Patterns

Service Layer Access Services handle file uploads, downloads, and content management with business logic validation.

CDN and Caching Built-in HTTP features enable global content delivery with appropriate caching strategies.

Key Design Organize objects with descriptive keys like users/123/profile.jpg or reports/2024/quarterly.pdf for logical organization.

Bucket storage excels at handling discrete files and media while keeping your databases focused on structured data.