> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Understanding Organizations

> Learn how to structure and manage organizations in Devin Enterprise

## What are Organizations?

Organizations in Devin Enterprise are logical groupings that provide structure and boundaries for your development teams. Each organization operates as a self-contained unit with its own shared Devin machine, repository access, and member permissions.

### Key Characteristics

**Shared Devin Machine**: Each organization has its own dedicated Devin machine that all members share. This ensures consistent environment setup and allows team members to collaborate on the same development context.

**Repository Isolation**: All repositories granted to an organization are accessible to all members within that organization. Repository access is managed at the organization level, not per individual user.

**Member Boundaries**: Users can belong to multiple organizations, but their access and permissions are scoped to each organization independently.

**Billing Separation**: Each organization has its own ACU (Agent Compute Unit) limits and usage tracking, enabling clear cost allocation across teams.

## Organization Structure

### Enterprise Hierarchy

```
Enterprise Account
├── Organization A (E-commerce Platform)
│   ├── Members: full-stack developers, product managers
│   └── Repositories: web-app, mobile-app, api-service, shared-components
├── Organization B (Analytics Platform)  
│   ├── Members: data engineers, backend developers
│   └── Repositories: data-pipeline, analytics-api, reporting-dashboard
└── Organization C (Infrastructure & Security)
    ├── Members: platform engineers, security engineers
    └── Repositories: infrastructure, deployment-scripts, security-tools
```

### Access Control Flow

1. **Enterprise Admin** creates organizations and manages overall enterprise settings
2. **Organization Admins** invite members to their specific organizations
3. **Members** access Devin and repositories within their assigned organizations
4. **Repository permissions** are granted by Enterprise Admins to organizations

## Planning Your Organization Structure

### Recommended Mapping Pattern

An effective approach is to **map each Devin organization to a GitHub/GitLab team**, which often aligns with your Identity Provider (IdP) groups and logical business applications. This provides a systemic way to scale up usage and manage access to repositories.

#### Example Mapping

| **GitHub Team**      | **Devin Organization** | **IdP Group**       | **Business Function**                        |
| :------------------- | :--------------------- | :------------------ | :------------------------------------------- |
| `ecommerce-platform` | E-commerce Platform    | `product-ecommerce` | Customer shopping experience (web, API, etc) |
| `analytics-platform` | Analytics Platform     | `product-analytics` | Data insights and reporting                  |
| `payments-team`      | Payments Platform      | `product-payments`  | Payment processing and billing               |
| `platform-infra`     | Infrastructure         | `eng-platform`      | Shared infrastructure and security           |

### Decision Framework

When planning your organization structure, consider these factors:

<Accordion title="Team Boundaries">
  **Question**: How are your development teams currently organized?

  **Guidance**: Create organizations that mirror your existing team structure. Teams that regularly collaborate on the same codebase should typically share an organization.

  **Example**: If your frontend and backend teams work closely on the same product, consider a single "Product Team" organization rather than separate frontend/backend organizations.
</Accordion>

<Accordion title="Repository Access Patterns">
  **Question**: Which repositories do different teams need access to?

  **Guidance**: Group teams that need access to the same set of repositories. Remember that all organization members can access all organization repositories.

  **Example**: If both your web and mobile teams need access to a shared design system repository, they might belong to the same organization.
</Accordion>

<Accordion title="Cost Allocation and Budgeting">
  **Question**: How do you want to track and allocate Devin usage costs?

  **Guidance**: Organizations provide natural cost centers for ACU usage tracking. Align organizations with your budgeting structure.

  **Example**: If you budget separately for each product line, create organizations that match those product boundaries.
</Accordion>

## Next Step

**Set Up Your First Organization**: Learn how to [create and configure organizations](/enterprise/getting-started/get-started#creating-organizations) in your enterprise account to start organizing your development teams.