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

# Apps (KODE OS)

> Learn how to create and manage buildings in your organization portfolio

The **Apps** page, available from the left-hand sidebar, is where you manage **KODE OS**. In Launchpad, KODE OS is the primary application and consolidates all products into a single building operating system.

Your channel partner activates KODE OS and enables products across your building portfolio. Once activated, you can assign KODE OS to users and specify a role that defines their permissions and allowed actions for each KODE OS product.

<Info>
  Only users with the **Admin** role in Launchpad can assign KODE OS and respective application roles. Refer to the list of [available Launchpad roles](/products/launchpad/get-started/accounts-and-users#client-organizations) for client organizations.
</Info>

Selecting **KODE OS** gives you access to three sections: **Details**, **Roles**, and **Users**.

## Details

This section provides an overview of KODE OS for your organization and the products enabled across your building portfolio.

Use the **Details** section to:

* View KODE OS application information
* View which products are enabled for your organization

```mermaid actions={false} theme={null}
---
config:
  theme: neutral
---
flowchart LR
 subgraph s1["Apps"]
        A1["KODE OS"]
  end
 subgraph s2["KODE OS sections"]
        D1["Details"]
        D2["Roles"]
        D3["Users"]
  end
 subgraph s3["Details"]
        P1["Application Details"]
        P2["Enabled products"]
  end
    A1 -- <br> ----- D1 & D3
    A1 -- <br> --- D2
    D1 -- View ----- P1 & P2

    linkStyle 0 stroke:#00C853,fill:none
    linkStyle 1 stroke:none
    linkStyle 2 stroke:none,fill:none
    linkStyle 3 stroke:#FF6D00,fill:
    linkStyle 4 stroke:#FF6D00,fill:none
```

## Roles

This section lists the KODE OS roles in your organization. You can create roles and define per-product Read and Write permissions for each role.

Use the **Roles** section to:

* View all KODE OS roles
* Create new roles and edit or delete existing ones
* Define per-product permissions for each role

See the [roles](/products/launchpad/client-organizations/apps#kode-os-roles) section for more details on KODE OS roles.

```mermaid actions={false} theme={null}
---
config:
  theme: neutral
---
flowchart LR
 subgraph s1["Apps"]
        A1["KODE OS"]
  end
 subgraph s2["KODE OS sections"]
        D1["Details"]
        D2["Roles"]
        D3["Users"]
  end
 subgraph s3["Roles"]
        P1["Role List"]
        P2["Role Creation"]
  end
    A1 -- <br> --- D1 & D3
    A1 -- access --- D2
    D2 -- View ----- P1 
    D2 -- Manage ----- P2

    linkStyle 0 stroke:none,fill:none
    linkStyle 2 stroke:#00C853,fill:none
    linkStyle 1 stroke:none,fill:none
    linkStyle 3 stroke:#FF6D00,fill:none
    linkStyle 4 stroke:#FF6D00
```

## Users

This section lists users in your organization and shows their KODE OS access and assigned role. You can assign KODE OS to users and change their role from here.

Use the **Users** section to:

* View which users have KODE OS access
* View or change the role assigned to each user
* Assign KODE OS to users who do not have access yet

```mermaid actions={false} theme={null}
---
config:
  theme: neutral
---
flowchart LR
 subgraph s1["Apps"]
        A1["KODE OS"]
  end
 subgraph s2["KODE OS sections"]
        D1["Details"]
        D2["Roles"]
        D3["Users"]
  end
 subgraph s3["Users"]
        P1["Users by Assigned Role"]
        P2["Role assignment"]
  end
    A1 -- <br> --- D1 & D2
    A1 -- access --- D3
    D3 -- View ----- P1 
    D3 -- Manage ----- P2

    linkStyle 0 stroke:none,fill:none
    linkStyle 2 stroke:#00C853,fill:none
    linkStyle 1 stroke:none,fill:none
    linkStyle 3 stroke:#FF6D00,fill:none
    linkStyle 4 stroke:#FF6D00
```

## KODE OS Roles

KODE OS uses roles to control what each user can access. A role defines permissions at the product level, letting you scope access to specific capabilities without granting full access to every product.

<Note>
  A user in Launchpad can only have one `KODE OS` role assigned to them at a time.
</Note>

<Tabs>
  <Tab title="Example 1">
    Three users have access to every product. Within each product, their role's **Read** and **Write** permissions define what they can view and do.

    ```mermaid actions={false} theme={null}
    ---
    config:
      layout: dagre
      theme: neutral
    ---
    flowchart LR
      CO["Client Organization"] --> users

      subgraph users["Users"]
        direction TB
        U1["User 1"]
        U2["User 2"]
        U3["User 3"]
        U4["User 4"]
        U5["User 5"]
      end

      subgraph roles["KODE OS Roles"]
        direction TB
        R1["Admin"]
      end

      U1 -- "Assigned Role" --> R1
      U2 -- "Assigned Role" --> R1
      U3 -- "Assigned Role" --> R1
      R1 -- "Per-product permissions" --> P1["Cloud BMS"]
      R1 -- "Per-product permissions" --> P2["FTT"]
      R1 -- "Per-product permissions" --> P3["FDD"]
      R1 -- "Per-product permissions" --> P4["OSS"]
      R1 -- "Per-product permissions" --> P5["BBI"]
      R1 -- "Per-product permissions" --> P6["AssetOps"]
      R1 -- "Per-product permissions" --> P7["Data Hub"]
      R1 -- "Per-product permissions" --> P8["EnerG"]

      linkStyle 1,2,3 stroke:#00C853,fill:none
      linkStyle 4,5,6,7,8,9,10,11 stroke:#FF6D00,fill:none
    ```
  </Tab>

  <Tab title="Example 2">
    Three users have access to reporting, diagnostics, energy, and monitoring products. Within each product, their role's **Read** and **Write** permissions define what they can view and do.

    ```mermaid actions={false} theme={null}
    ---
    config:
      layout: dagre
      theme: neutral
    ---
    flowchart LR
    subgraph users["Users"]
    direction TB
        U1["User 1"]
        U2["User 2"]
        U3["User 3"]
        U4["User 4"]
        U5["User 5"]
    end
    subgraph roles["KODE OS Roles"]
    direction TB
        R1["Analytics"]
    end
    CO["Client Organization"] --> users
    U4 -- Assigned Role --> R1
    U5 -- Assigned Role --> R1
    R1 -- "Per-product permissions" --> P5["Cloud BMS"] & P1["BBI"] & P2["Data Hub"] & P3["EnerG"] & P4["FDD"]

    linkStyle 0 stroke:#00C853,fill:none
    linkStyle 1 stroke:#00C853,fill:none
    linkStyle 2 stroke:#00C853,fill:none
    linkStyle 3 stroke:#FF6D00,fill:none
    linkStyle 4 stroke:#FF6D00,fill:none
    linkStyle 5 stroke:#FF6D00,fill:none
    linkStyle 6 stroke:#FF6D00,fill:none
    linkStyle 7 stroke:#FF6D00,fill:none
    ```
  </Tab>
</Tabs>

## Create KODE OS Roles

Follow the steps outlined below to create a new `KODE OS` role.

<Steps>
  <Step title="Open KODE OS in Apps">
    From the left-hand sidebar, open **Apps** and select **KODE OS**.
  </Step>

  <Step title="Go to the Roles page">
    Within KODE OS, navigate to the **Roles** page.
  </Step>

  <Step title="Create a new role">
    Click `+Add Role` to start creating a new role.
  </Step>

  <Step title="Configure role details">
    Enter a **name** and **description** for the role, then define permissions.

    See the [permissions reference](/products/launchpad/client-organizations/apps/permissions-reference) for more details.
  </Step>

  <Step title="Save the role">
    Click **Save**. The role is now available when assigning KODE OS to users.
  </Step>
</Steps>

## Assign KODE OS Roles

Follow the steps outlined below to assign KODE OS and a role to a user.

<Steps>
  <Step title="Open KODE OS in Apps">
    From the left-hand sidebar, open **Apps** and select **KODE OS**.
  </Step>

  <Step title="Go to the Users page">
    Within KODE OS, navigate to the **Users** page.
  </Step>

  <Step title="Assign a KODE OS role to a user">
    Click `+Assign User`, select the users, and click `+Assign User(s)` to confirm.
  </Step>
</Steps>