Skip to content

Groups

Every Turso database belongs to a group. The group decides where its databases run.

Create a group

Section titled “Create a group”
const group = yield* Turso.Group("Group", { location: "aws-us-east-1" });

location defaults to aws-us-east-1. Run turso db locations to see the others.

Changing location creates a new group. The old group and its databases are deleted.

Name it

Section titled “Name it”
const group = yield* Turso.Group("Group", {
  name: "production",
  location: "aws-eu-west-1",
});

Without name, Alchemy picks one for each stage. Names must be unique in your organization.

Enable extensions

Section titled “Enable extensions”
const group = yield* Turso.Group("Group", { extensions: "all" });

Pass "all" or a list of extension names. Changing extensions creates a new group.

Protect it from deletion

Section titled “Protect it from deletion”
const group = yield* Turso.Group("Group", { deleteProtection: true });

While this is on, you can’t destroy the group. Set it to false and deploy first.

Delete a group

Section titled “Delete a group”

Destroying a group deletes every database in it, including ones your app created with ManageDatabases.

Replicas

Section titled “Replicas”

replicas adds read-only copies in other locations. Groups on AWS don’t support this. It only works for older groups hosted on Fly.

Where next

Section titled “Where next”