Introduction to Erebus

Real-time infrastructure built on Cloudflare Durable Objects.

Erebus

Erebus is a real-time infrastructure platform built on Cloudflare Durable Objects. It gives you managed pub/sub channels with presence, message history, and at-least-once delivery — so you can add real-time features without running your own WebSocket servers or message brokers.

Beta

Erebus is in beta. APIs may change between releases. For questions or feedback, reach out at x.com/v0id_user.

What you get

  • Pub/Sub Channels — publish and subscribe to topics with ULID-ordered message delivery.
  • Presence — automatic join/leave events for every subscriber in a channel.
  • Message History — cursor-based pagination to fetch past messages.
  • Acknowledgments — MQTT-style QoS 1 for at-least-once delivery.

Quick example

import { ErebusClient, ErebusClientState } from "@erebus-sh/sdk/client";

const client = ErebusClient.createClient({
  client: ErebusClientState.PubSub,
  authBaseUrl: "https://your-auth-server.com",
});

client.joinChannel("my-app");
await client.connect();

await client.subscribe("chat", (msg) => {
  console.log(msg.senderId, msg.payload);
});

await client.publish("chat", "hello world");

Documentation

SectionWhat it covers
Getting StartedInstall the SDK, set up auth, connect your first client.
ConceptsHow channels, presence, history, and QoS work under the hood.
SDK ReferenceFull API docs for the Core and React clients.
PlatformDashboard, API keys, analytics, and audit logs.