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

# Onboarding

> Setting up your organization in Ultra Hub

When you first sign up for Ultra Hub, the onboarding wizard guides you through creating your organization structure.

## Onboarding Steps

<Steps>
  <Step title="Create Organization">
    Choose a name and slug for your organization. The slug is used in URLs and API calls.

    * **Name**: Your company or team name (e.g., "Acme Corp")
    * **Slug**: URL-friendly identifier (e.g., "acme-corp")
  </Step>

  <Step title="Create Team">
    Teams are groups within your organization. Start with one team and add more later.

    * **Name**: Team name (e.g., "Engineering")
  </Step>

  <Step title="Create Workspace">
    Workspaces contain gateways and their telemetry data. Use workspaces to separate environments.

    * **Name**: Workspace name (e.g., "Development")
    * Typical setup: separate workspaces for Development, Staging, Production
  </Step>

  <Step title="Complete">
    You're ready to link gateways. The wizard shows next steps:

    * Install Ultra on developer machines
    * Run `ultra login` to authenticate
    * Run `ultra link` to link gateways to your workspace
  </Step>
</Steps>

## After Onboarding

Once onboarding is complete, you can invite team members to your organization.

### Inviting Team Members

From the Hub web UI:

1. Go to **Settings > Invites**
2. Click **Invite Member**
3. Enter the team member's email address
4. Select a role (Owner, Admin, Member, or Viewer) — see [Roles & Permissions](/hub/rbac) for details
5. Click **Send Invite**

The invited user receives an email with a link to join your organization. Once they accept, they can:

1. **Login** from the CLI: `ultra login`
2. **Link** their gateway to a workspace: `ultra link`

Each linked gateway automatically syncs traces and audit events to Hub, providing team-wide visibility into MCP tool usage.

## Organization Hierarchy

```
Organization (Acme Corp)
├── Team (Engineering)
│   ├── Workspace (Development)
│   │   ├── Gateway (Alice's MacBook)
│   │   ├── Gateway (Bob's MacBook)
│   │   └── Gateway (CI Runner)
│   └── Workspace (Production)
│       └── Gateway (prod-gateway-1)
└── Team (Security)
    └── Workspace (Security Review)
        └── Gateway (security-scanner)
```

```mermaid theme={null}
graph TD
    Org["<b>Organization</b><br/>Acme Corp"]

    TE["<b>Team</b><br/>Engineering"]
    TS["<b>Team</b><br/>Security"]

    WD["<b>Workspace</b><br/>Development"]
    WP["<b>Workspace</b><br/>Production"]
    WSR["<b>Workspace</b><br/>Security Review"]

    G1["Gateway: Alice's MacBook"]
    G2["Gateway: Bob's MacBook"]
    G3["Gateway: CI Runner"]
    G4["Gateway: prod-gateway-1"]
    G5["Gateway: security-scanner"]

    Org --> TE
    Org --> TS
    TE --> WD
    TE --> WP
    TS --> WSR
    WD --> G1
    WD --> G2
    WD --> G3
    WP --> G4
    WSR --> G5
```