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

# Workspaces

> Organize resources and billing with workspaces.

export const RuncrateStyles = () => {
  if (typeof document !== 'undefined' && !document.getElementById('runcrate-overrides')) {
    const s = document.createElement('style');
    s.id = 'runcrate-overrides';
    s.textContent = `
      /* Match Runcrate's rounding scale (--radius: 0.75rem) */
      .rounded-sm { border-radius: 0.5rem !important; }   /* 8px */
      .rounded-md { border-radius: 0.625rem !important; } /* 10px */
      .rounded-lg { border-radius: 0.75rem !important; }  /* 12px */
      .rounded-l-sm { border-top-left-radius: 0.5rem !important; border-bottom-left-radius: 0.5rem !important; }
      .rounded-r-sm { border-top-right-radius: 0.5rem !important; border-bottom-right-radius: 0.5rem !important; }
      .rounded-l-md { border-top-left-radius: 0.625rem !important; border-bottom-left-radius: 0.625rem !important; }
      .rounded-r-md { border-top-right-radius: 0.625rem !important; border-bottom-right-radius: 0.625rem !important; }
      .rounded-l-lg { border-top-left-radius: 0.75rem !important; border-bottom-left-radius: 0.75rem !important; }
      .rounded-r-lg { border-top-right-radius: 0.75rem !important; border-bottom-right-radius: 0.75rem !important; }

      /* Cards: never pure white in light mode */
      .card { background-color: #fcfcfc !important; border-radius: 0.75rem !important; }
      html.dark .card { background-color: #141414 !important; }

      /* Docs hero box */
      .rc-hero { background-color: #fcfcfc; border: 1px solid #e0e0e0; }
      html.dark .rc-hero { background-color: #141414; border-color: #242424; }
      html.dark .rc-hero h1 { color: #f5f5f5; }

      /* Runcrate scrollbar — thin, transparent track, hide-until-hover thumb */
      ::-webkit-scrollbar { width: 6px; height: 6px; background-color: transparent; }
      ::-webkit-scrollbar-track { background-color: transparent; }
      ::-webkit-scrollbar-thumb { background-color: rgba(155, 155, 155, 0.5); border-radius: 10px; transition: opacity 0.3s ease; opacity: 0; }
      ::-webkit-scrollbar-thumb:hover { background-color: rgba(155, 155, 155, 0.7); }
      *:hover::-webkit-scrollbar-thumb,
      *:focus::-webkit-scrollbar-thumb,
      *:active::-webkit-scrollbar-thumb { opacity: 1; }
      * { scrollbar-width: thin; scrollbar-color: rgba(155, 155, 155, 0.5) transparent; }
    `;
    document.head.appendChild(s);
  }
  return null;
};

<RuncrateStyles />

Workspaces are the top-level organizational unit in Runcrate. Each workspace has its own instances, storage volumes, API keys, billing, and team members.

## Why Workspaces?

* **Isolate resources** — Instances, storage, and keys are scoped to a workspace
* **Separate billing** — Each workspace has its own credit balance and transaction history
* **Team access control** — Invite collaborators to specific workspaces with role-based permissions

## Creating a Workspace

<Steps>
  <Step title="Open the Workspace Selector">
    Click the workspace name in the sidebar to open the workspace selector.
  </Step>

  <Step title="Click Create Workspace">
    Click **Create Workspace** at the bottom of the selector.
  </Step>

  <Step title="Enter Workspace Name">
    Give your workspace a descriptive name (e.g., `research-lab`, `production-api`).
  </Step>

  <Step title="Create">
    Click **Create**. You will be switched to the new workspace automatically.
  </Step>
</Steps>

## Switching Workspaces

Use the **workspace selector** in the sidebar to switch between workspaces. All dashboard pages (instances, storage, billing, keys, team) will update to show resources for the selected workspace.

## Default Workspace

When you sign up, a default workspace is created for you automatically. You can:

* Rename it at any time
* Change which workspace is your default
* Create additional workspaces as needed

## Deleting a Workspace

<Warning>
  Deleting a workspace is permanent and will **terminate all running instances**, **delete all storage volumes**, and **remove all team members** from the workspace. Only the workspace **Owner** can delete a workspace.
</Warning>

To delete a workspace:

1. Go to **Dashboard → Workspaces**
2. Select the workspace you want to delete
3. Click **Delete Workspace**
4. Confirm the deletion

## Invitations

When someone invites you to their workspace:

1. Go to **Dashboard → Workspaces**
2. You will see pending invitations
3. Click **Accept** to join the workspace or **Decline** to reject the invitation
4. Once accepted, the workspace will appear in your workspace selector