Platform Guide

Futrou organizes everything you run into two levels: workspace and project.

Workspace

A workspace is the top-level account — it holds billing, members, and every project underneath it, representing a single tenant: an organization or an individual. Every user gets a personal workspace automatically, and can create or be invited to additional team workspaces. Aside from having exactly one member, a personal workspace works the same as a team one: same billing, same projects, same services.

A workspace has its own credit balance, currency, and resource limits (how many serverlets, proxies, DNS zones, and so on it can hold), along with team members and their roles. Every workspace has at least one Owner — see Roles for what each role can do.

Projects

A project is a grouping of services inside a workspace — typically one per application or environment (for example, separate staging and production projects). Every workspace starts with a project named default, and you can create more at any time. If the default project is deleted, the Futrou CLI recreates it the next time it’s referenced by a futrou deploy — you don’t need to create it back by hand.

A project can be renamed, or transferred to another workspace you have access to without downtime — useful when a project outgrows a personal workspace and needs to move under a team one.

A service always belongs to exactly one project, and a project always belongs to exactly one workspace — there’s no sharing a serverlet or DNS zone across projects. If two applications need to talk to each other, put them in the same project, or connect them over their public proxy addresses like any other external service.