Build with Actors

Edge Networking

Actors run near your users on Rivet's global network by default.

Region selection

Automatic region selection

By default, actors will choose the optimal region based on the client's location.

Note

Under the hood, Rivet uses Anycast routing to automatically find the best location for the client to connect to without relying on slow & expensive manual pinging process.

Manual region selection

The region an actor is created in can be overridden by defining create.region:

const actor = client.get(
	{ name: "example" },
	{
		create: {
			region: "atl",
		},
	}
);

client.ts

See Create & Manage Actors for more information.

Available regions

See available regions here.

Fetching region list

It's common to need to display a list of available regions in your application.

To fetch a full list of regions, you can use the GET https://api.rivet.gg/regions HTTP endpoint. See API documentation here.

We don't recommend hard-coding the region list. This allows you to develop your application with a local development cluster.