Spaces

Spaces are hierarchical organizational units that let you group stacks and control access across your Zenfra organization. They enable multi-tenant environments where different teams or projects can operate independently within the same organization.

Overview

Every Zenfra organization starts with a root space. You can create child spaces under root, and child spaces under those, forming a tree structure. Stacks are assigned to a space when created.

Spaces serve two purposes:

Organization — logically group stacks by team, environment, project, or any other criteria
Access isolation — control which users and resources can interact with stacks in a given space

Space properties

Property	Description
Name	A human-readable name for the space
ID	A unique identifier (slug) for the space
Inherit	Whether the space inherits configuration from its parent space

Space tree

The Spaces page displays your spaces as a collapsible tree structure, reflecting the parent-child hierarchy. Each space shows its name, ID, and whether inheritance is enabled.

For example:

root
├── child-space
│   └── chichild (inherits: yes)

Creating a space

Click Create Space on the Spaces page. You will need to provide:

Name — a descriptive name for the space
Parent — which existing space this will be a child of
Inherit — whether to inherit configuration from the parent

Inheritance

When a space has inheritance enabled, it can receive shared configuration from its parent space. This is useful for applying organization-wide settings (such as shared bundles or integrations) while allowing child spaces to maintain their own specific configuration.

Assigning stacks to spaces

When creating a stack, you select which space it belongs to in the Basic Info step. The space determines the organizational context and access scope for that stack.

Managing spaces

Each space in the tree has an actions menu (three dots) that allows you to edit or delete the space. A space cannot be deleted if it still contains stacks or child spaces.