Rivet.Hetzner reference

ServerControlPlane

Source: packages/rivet/src/Hetzner/ServerControlPlane.ts

A Rivet control plane on Hetzner Cloud, as a Rivet.Cluster Layer: Servers running the engine container, each with a Volume of its own, on a private Network they talk to each other over, behind a private Load Balancer. An edge Server runs Caddy in front of it and serves the engines over HTTPS at its own address under sslip.io (https://203-0-113-7.sslip.io), with a certificate from Let’s Encrypt, so it needs no domain of your own. A firewall drops every other inbound connection to the engines. A namespace is created for the stage.

One engine keeps actor data on its Volume. Several share it through objectStorage — Hetzner Object Storage, or any S3-compatible bucket.

Pools of nodes anywhere reach it at its public address — RivetHetzner.ServerPool on Hetzner, or a pool on any other cloud.

ServerControlPlane: Running a control plane on Hetzner

One engine

export const Cluster = RivetHetzner.ServerControlPlane("Rivet");

Three engines sharing Hetzner Object Storage

export const Cluster = RivetHetzner.ServerControlPlane("Rivet", {
  instances: 3,
  objectStorage: {
    kind: "s3",
    bucket: "my-rivet-data",
    endpoint: "https://nbg1.your-objectstorage.com",
    region: "nbg1",
    accessKeyId: Config.String("HETZNER_S3_ACCESS_KEY_ID"),
    secretAccessKey: Config.Redacted("HETZNER_S3_SECRET_ACCESS_KEY"),
  },
});

ServerPool

Source: packages/rivet/src/Hetzner/ServerPool.ts

Run a pool’s nodes on Hetzner Cloud: a pool on the control plane, and Servers that each run every Rivet.DurableObject given this pool as a Hetzner.Service. Nodes only connect out to the control plane, so a firewall drops every inbound connection except SSH, which deploys them; the pool works with any control plane it can reach — RivetHetzner.ServerControlPlane, RivetCloud.ControlPlane, or one on another cloud.

Every Durable Object given the same pool shares its nodes: declare the pool once and provide it to each class.

ServerPool: Running Durable Objects on Hetzner

export const Cluster = RivetHetzner.ServerControlPlane("Rivet");
export const Default = RivetHetzner.ServerPool("Default", { replicas: 2 }).pipe(
  Layer.provide(Cluster),
);

ServicesPool

Source: packages/rivet/src/Hetzner/ServicesPool.ts

Run Rivet Services on Hetzner Cloud: the services pool on the control plane, and Servers running Rivet’s prebuilt Services node on Docker, which hosts Durable Streams and agentOS. A firewall drops every inbound connection: callers reach every stream through the control plane’s gateway, with its token. Works with any control plane it can reach.

ServicesPool: Running Rivet Services on Hetzner

export const Cluster = RivetHetzner.ServerControlPlane("Rivet");
export const Services = RivetHetzner.ServicesPool("Services").pipe(Layer.provide(Cluster));