Skip to main content

Event Providers

Safebucket uses event providers for asynchronous processing of notifications, file operations, and storage events.

Available Providers​

  • NATS JetStream: Distributed messaging with work-queue retention and explicit acknowledgment.
  • Google Cloud Pub/Sub: GCP-native messaging service.
  • AWS SQS: AWS Simple Queue Service.
  • Memory: In-process event queue using Go channels. Single-instance only.
Which provider should I use?

Use Memory for development and testing (single instance). Use JetStream, GCP Pub/Sub, or AWS SQS for production deployments.

Queue Configuration​

All event providers require three named queues. These are configured independently of the provider type.

Environment Variables​

EVENTS__QUEUES__NOTIFICATIONS__NAME=safebucket-notifications
EVENTS__QUEUES__BUCKET_EVENTS__NAME=safebucket-bucket-events
EVENTS__QUEUES__OBJECT_DELETION__NAME=safebucket-object-deletion

YAML Configuration​

events:
  queues:
    notifications:
      name: safebucket-notifications
    bucket_events:
      name: safebucket-bucket-events
    object_deletion:
      name: safebucket-object-deletion
VariableDescriptionDefaultRequired
EVENTS__QUEUES__NOTIFICATIONS__NAMENotification events queue-✅
EVENTS__QUEUES__BUCKET_EVENTS__NAMEStorage bucket events queue-✅
EVENTS__QUEUES__OBJECT_DELETION__NAMEObject deletion events queue-✅
Bucket events

The bucket_events queue receives events emitted by the storage provider (uploads, deletions). Only dedicated storage providers (RustFS, MinIO, AWS S3, GCP, Generic S3) emit these events. The queue name is still required in configuration regardless of the storage provider used.