Skip to main content

Self-Hosting Overview

Self-hosting Rivet gives you complete control over the actor orchestration platform and infrastructure.

Self-Host vs BYOC

Self-Host

YOUR INFRASTRUCTUREYour Backend(Envoy)Rivet EngineStorage

BYOC with Rivet Cloud

YOUR INFRASTRUCTURERIVET CLOUDYour Backend(Envoy)Rivet EngineStorage

Rivet supports both BYOC (Bring Your Own Cloud) and self-hosting to fit your deployment needs.

Self-HostingBYOC with Rivet Cloud
You ManageFull stack (your backend, engine, Rivet Engine, database)Only your backend
ComplexityHigher (full stack deployment)Lower (connect and deploy)
CostHigher operational overheadUsually lower usage-based cost
Supports ServerlessRequires extra infrastructureYes
Air-Gapped DeploymentsYesNo
Best ForAir-gapped environments, strict compliance, custom security policiesAll other production deployments
SupportContact sales or communityCommunity, Slack, and email (varies by plan)
DocumentationContinue belowSee connect guides

Architecture

Your Backend(Envoy)Rivet EngineStorage(PG or FS)

Rivet has 3 core components:

  • Your Backend: Your application server that handles user requests and includes an envoy component that executes actor code
  • Rivet Engine: Main orchestration service that manages actor lifecycle, routes messages, and provides APIs
  • Storage: Persistence layer for actor state and messaging infrastructure for real-time communication

Storage Backends

Rivet supports multiple storage backends:

  • File System: Recommended for smaller single-node deployments today
  • PostgreSQL: Recommended for multi-node deployments; production-ready for light-to-moderate workloads, not built for enterprise scale
  • FoundationDB: Best scalability and performance for production-ready deployments (requires enterprise)

Deployment Platforms

Deploy Rivet on your preferred platform:

Self-hosting guides coming soon.

Next Steps