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

# Setup Your Account

> Register, create your workspace, connect your cloud, invite your team, and upgrade your plan — everything you need before using CloudThinker.

## What You'll Set Up

This tutorial walks you through the complete initial setup — from creating your account to having a fully configured workspace ready for your team.

<Steps>
  <Step title="Register Your Account">
    Go to [app.cloudthinker.io](https://app.cloudthinker.io/auth/register) and create your account:

    1. Enter your **full name**, **email**, and **password**
    2. Check your inbox and click the **verification link**
    3. Complete your profile

    After registration, you'll have a personal organization and a default workspace automatically created for you.
  </Step>

  <Step title="Create Your Workspace">
    Your default workspace is ready to use, but you may want to configure it or create additional ones.

    Go to the **Organizations** page and click **New Workspace**:

    1. **Select cloud provider**: Choose AWS, GCP, or Azure (cannot be changed later)
    2. **Name your workspace**: Use something descriptive like "Production AWS" or "Dev Team GCP"
    3. **Add a description**: Note the purpose, environment, or team

    <Warning>
      The cloud provider selection is permanent for each workspace. If you need multiple providers, create separate workspaces.
    </Warning>

    **Common workspace patterns**:

    | Pattern        | Example Workspaces                                    |
    | -------------- | ----------------------------------------------------- |
    | By environment | "Production AWS", "Staging AWS", "Dev AWS"            |
    | By team        | "Platform Team", "Security Team", "Backend Team"      |
    | By provider    | "AWS Operations", "GCP Analytics", "Azure Enterprise" |
  </Step>

  <Step title="Connect Your Cloud">
    In your workspace, go to **Settings** > **Connections** to link your cloud account.

    <Tabs>
      <Tab title="AWS">
        Two options:

        **Option A: IAM Role (recommended)**

        * Create a cross-account IAM Role with read-only permissions
        * Provide the **Role ARN** to CloudThinker

        **Option B: Access Key**

        * Create an IAM user with read-only permissions
        * Provide the **Access Key ID** and **Secret Access Key**

        CloudThinker will discover your resources automatically once connected.
      </Tab>

      <Tab title="GCP">
        You'll need:

        * **Service Account Key** (JSON file)
        * **Project ID**

        Create a service account in GCP Console with Viewer role, then download the JSON key.
      </Tab>

      <Tab title="Azure">
        You'll need:

        * **Client ID** and **Client Secret**
        * **Tenant ID**
        * **Subscription ID**

        Register an application in Azure AD with Reader RBAC role.
      </Tab>
    </Tabs>

    <Card title="Detailed Connection Guides" icon="plug" href="/guide/connections/overview">
      Step-by-step instructions for each provider
    </Card>
  </Step>

  <Step title="Invite Your Team">
    Go to your **Organization** settings and click the **Members** icon:

    1. Click **Invite Members**
    2. Enter email addresses (up to 10 at a time)
    3. Select a role for the invitees
    4. Assign workspace access (optional — Owners and Admins see all workspaces automatically)
    5. Click **Send Invites**

    ### Roles at a Glance

    | Role          | Can Do                                                         | Best For                     |
    | ------------- | -------------------------------------------------------------- | ---------------------------- |
    | **Owner**     | Everything — billing, [BYOK](/guide/byok), members, workspaces | Account holder, 1-2 per org  |
    | **Admin**     | Manage members, create workspaces, all workspace access        | Team leads, senior engineers |
    | **Developer** | Use agents, run operations in assigned workspaces              | Most team members            |
    | **Viewer**    | Read-only access to assigned workspaces                        | Stakeholders, auditors       |

    <Note>
      You can override roles per workspace. For example, give a Viewer Developer access in a specific workspace where they need to run operations.
    </Note>
  </Step>

  <Step title="Upgrade Your Plan">
    Go to **Organization** settings > **Subscription** tab to review your plan.

    CloudThinker uses **per-seat billing** — each seat grants a credit allocation and allows one active member.

    | Plan           | Seats        | Best For                                  |
    | -------------- | ------------ | ----------------------------------------- |
    | **Starter**    | 1 member     | Individual exploration                    |
    | **Pro**        | Start with 1 | Small teams getting started               |
    | **Team**       | Start with 1 | Growing teams with multiple workspaces    |
    | **Business**   | Minimum 5    | Mid-size organizations                    |
    | **Enterprise** | Minimum 25   | Large organizations with governance needs |

    To upgrade:

    1. Click **Upgrade** on the Subscription tab
    2. Select your plan
    3. Add the number of seats your team needs
    4. Enter payment details

    <Tip>
      Start with **Pro** and upgrade as your team grows. You can add seats at any time without changing plans.
    </Tip>
  </Step>

  <Step title="Configure Integrations (Optional)">
    Set up additional integrations to get the most out of CloudThinker:

    <CardGroup cols={2}>
      <Card title="Slack Integration" icon="slack" href="/guide/slack-integration">
        Run operations from Slack — install the CloudThinker app in your workspace
      </Card>

      <Card title="BYOK" icon="key" href="/guide/byok">
        Use your own AWS Bedrock credentials for unlimited LLM operations
      </Card>
    </CardGroup>
  </Step>
</Steps>

***

## Setup Checklist

Use this checklist to make sure everything is configured:

* [ ] Account registered and email verified
* [ ] Workspace created with cloud provider selected
* [ ] Cloud connection configured
* [ ] Team members invited with appropriate roles
* [ ] Plan upgraded if needed for team size
* [ ] Slack integration connected (optional)

***

## Next Step

<Card title="VibeOps: Your First Conversation" icon="comments" href="/guide/tutorial/vibeops">
  Start talking to AI agents — learn the conversational approach to cloud operations
</Card>