Organizations

OpenFactory provides enterprise-ready multi-tenant organization management with hierarchical access control.

Overview

Organizations enable teams to collaborate on Linux distribution builds with proper access controls and sharing.

Organization (Company)
├── Members (owner, admin, member)
├── Groups (for easy sharing)
├── Units (departments)
│   ├── Unit Members
│   └── Teams (working groups)
│       └── Team Members

Key Concepts

Organization

The top-level container representing a company or tenant.

• Each user can belong to multiple organizations
• Provides tenant isolation for data
• Controls who can access builds and configurations

Units

Organizational divisions within a company (departments, business units).

• Infrastructure Units - IT/platform teams managing base images
• Business Units - Teams creating variant configurations

Teams

Working groups within units.

• Smallest organizational unit
• Where most daily collaboration happens
• Variants are typically shared at team level

Groups

Collections of users for simplified sharing.

• Cross-unit sharing without changing structure
• Easy bulk permissions
• Named collections (e.g., “Approvers”, “Reviewers”)

Hierarchy Diagram

┌─────────────────────────────────────────────────────────┐
│                     ORGANIZATION                         │
│  "Acme Corporation"                                      │
├─────────────────────────────────────────────────────────┤
│                                                          │
│  ┌─────────────────┐    ┌─────────────────┐            │
│  │     UNIT        │    │     UNIT        │            │
│  │  "Central IT"   │    │  "Manufacturing"│            │
│  ├─────────────────┤    ├─────────────────┤            │
│  │                 │    │                 │            │
│  │ ┌───────────┐  │    │ ┌───────────┐  │            │
│  │ │   TEAM    │  │    │ │   TEAM    │  │            │
│  │ │ "Platform"│  │    │ │ "Plant A" │  │            │
│  │ └───────────┘  │    │ └───────────┘  │            │
│  │                 │    │                 │            │
│  │ ┌───────────┐  │    │ ┌───────────┐  │            │
│  │ │   TEAM    │  │    │ │   TEAM    │  │            │
│  │ │ "Security"│  │    │ │ "Plant B" │  │            │
│  │ └───────────┘  │    │ └───────────┘  │            │
│  │                 │    │                 │            │
│  └─────────────────┘    └─────────────────┘            │
│                                                          │
└─────────────────────────────────────────────────────────┘

Getting Started

Creating an Organization

1. Go to Settings → Organizations
2. Click Create Organization
3. Enter organization name
4. You become the owner

Inviting Members

1. Open organization settings
2. Go to Members tab
3. Click Invite
4. Enter email address
5. Select role (admin or member)
6. Send invitation

Creating Units

1. Open organization settings
2. Go to Units tab
3. Click Create Unit
4. Enter unit name and description
5. Add members

Creating Teams

1. Open a unit
2. Click Create Team
3. Enter team name
4. Add members from the unit

Organization Switcher

Switch between organizations using the dropdown in the sidebar:

1. Click your current organization name
2. Select a different organization
3. View changes to available resources

The current organization context affects:

• Which builds you see
• Who you can share with
• Available units and teams

Quick Links

Tenant Isolation

OpenFactory enforces strict tenant isolation:

• Conversations are tagged with organization ID
• Sharing is restricted to same-organization users
• Cross-tenant access is prevented at the API level
• Data is logically separated by organization