RivenGet started

Search docs

Find a page across the Riven documentation

Riven Mail

Live

Real mailboxes, provisioned at signup. Every Riven account gets mail and comms together, on infrastructure the platform controls end to end.

Riven Mail is a first-class mail service, not a notification sender. When an account is created, mail and [comms](/docs/commerce/riven-comms) are provisioned together at signup — the user has an addressable mailbox before they have written a line of code.

Provisioning at signup#

  1. The account is created through Riven Auth.
  2. A mailbox is allocated and its credentials are sealed into Riven Keymaster — they are never shown in a response body.
  3. Comms channels are attached to the same identity, so mail and messaging share one address book.
  4. The mailbox appears in the account’s surfaces immediately; no separate onboarding step.

Because provisioning happens inline with signup, a failed mailbox allocation fails the signup rather than silently leaving an account without mail. There is no “mail pending” state to reconcile later.

What it runs#

  • Transport — SMTP submission and delivery with SPF, DKIM, and DMARC aligned per sending domain.
  • Storage — IMAP-accessible mailboxes with server-side search.
  • Routing — inbound rules that hand messages to Commerce as orders or quotes, or to a support queue.
  • Reputation — bounce and complaint handling fed back into Riven Telemetry so deliverability is observable, not guessed at.

AI on the inbox#

Triage, summarisation, and draft replies run through the gateway with the same key and quota as any other workload. Drafts land in the drafts folder — nothing is sent without an explicit human send.

WorkflowModel behaviourHuman step
TriageClassifies and labels inbound mailOptional review of low-confidence labels
Summarise threadProduces a thread digest on demandNone — read-only
Draft replyWrites a draft with cited contextRequired — the user sends
Extract orderProposes line items into CommerceRequired — the operator confirms

Sovereignty#

Mail is self-hosted on the same Docker Swarm cluster as the rest of the platform, fronted by Traefik and deployed with Dokploy. Message bodies are not sent to a third-party mail provider, and model calls that touch mail content prefer the on-prem fleet.