> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-ltxv2-serverless.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams Quickstart

<script
  type="application/ld+json"
  dangerouslySetInnerHTML={{
__html: JSON.stringify({
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to Get Started with Vast.ai Teams",
"description": "A quickstart guide to creating a team, inviting team members, assigning roles, and using SSH keys with team instances on Vast.ai.",
"step": [
  {
    "@type": "HowToStep",
    "name": "Create Your Team",
    "text": "There are two ways to create a team: Click on your profile name in the Context Switcher and click the Create Team button, or navigate to the Members section in the Sidebar and click Create Team. Enter your Team Name and optionally transfer some credit to your team during creation by selecting the 'Transfer my personal credits' checkbox. Click Create to finish."
  },
  {
    "@type": "HowToStep",
    "name": "Understand Default Team Roles",
    "text": "Every team comes with two default roles: Manager (full access to team resources) and Member (limited read access to most resources while still being able to rent instances). You can view and manage these roles from the Members Page."
  },
  {
    "@type": "HowToStep",
    "name": "Create Custom Roles (Optional)",
    "text": "To create a new role with custom permissions, navigate to the Roles tab of the Members Page. Name the role and choose the permission groups that the new role will have access to. Once satisfied, click Generate to create the new role."
  },
  {
    "@type": "HowToStep",
    "name": "Invite Team Members",
    "text": "Go to the Members Page and click the Invite button. Enter the email and team role for the person you want to invite, then click Invite to send the invitation email. The invitee will receive an email with a link to join your team. Note: If the recipient does not have a Vast account, they will need to create one before being added to your team."
  },
  {
    "@type": "HowToStep",
    "name": "Set Up SSH Keys for Team Instances",
    "text": "For VM Instances: Add your SSH key to your personal account before the VM is created. For Non-VM Instances: Either add your SSH key directly to the instance or add your key to your personal account, and it will be automatically applied to the team instance."
  }
]
})
}}
/>

## Introduction

This quickstart guide will walk you through how to create a team, invite new team members and assign them to different roles.

## Creating the Team

There are two ways to create a team:

1. Click on your profile name (or email address) in the Context Switcher and then click the **Create Team** button
2. Or you can navigate to the **Members** section in the Sidebar and click **Create Team**

<Frame caption="Create Team">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/EVv-IFlz-DsWmGpt/images/teams-quickstart.webp?fit=max&auto=format&n=EVv-IFlz-DsWmGpt&q=85&s=b3b5fc911ab18f9dc67820ad10f3afab" alt="" width="800" height="464" data-path="images/teams-quickstart.webp" />
</Frame>

<Frame caption="Members Page">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/EVv-IFlz-DsWmGpt/images/teams-quickstart-2.webp?fit=max&auto=format&n=EVv-IFlz-DsWmGpt&q=85&s=ee361aed1ea6a7ee9325d0036f2fdc39" alt="" width="800" height="379" data-path="images/teams-quickstart-2.webp" />
</Frame>

Once there, you can create your **Team Name** and transfer some credit to your team during creation. You can also skip the credit transfer step and do it later from the [**Billing Page**](/documentation/reference/billing#a6bsE).

To add credit during team creation, select **Transfer my personal credits** checkbox, enter an amount, and then click **Create**.

<Frame caption="Team Creation">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/EVv-IFlz-DsWmGpt/images/teams-quickstart-3.webp?fit=max&auto=format&n=EVv-IFlz-DsWmGpt&q=85&s=4bc73b1771e6982106c0e7766e7bf23b" alt="" width="800" height="720" data-path="images/teams-quickstart-3.webp" />
</Frame>

After successfully creating the team you should see your Team Name and role in the Context Switcher in the upper left corner and the Team Dashboard on the **Members** page.

<Frame caption="Members Page">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/EVv-IFlz-DsWmGpt/images/teams-quickstart-4.webp?fit=max&auto=format&n=EVv-IFlz-DsWmGpt&q=85&s=975660a367b3937fd8ba7ee39a033173" alt="" width="1079" height="419" data-path="images/teams-quickstart-4.webp" />
</Frame>

The **Members** section is the main way that team owners and managers can interact with the Teams ecosystem. From here you can invite team members, create/manage team roles, remove team members, etc.

## Managing Team Roles

Every team comes with two default roles: manager and member.

Managers have full access to team resources, while members have limited read access to most resources while still being able to rent instances. [Learn more.](/documentation/teams/teams-roles)

To create a new role with your desired permissions, navigate to the **Roles** tab of the **Members** **Page**. Then you can name the role and choose the permission groups that the new role will have access to. Once you are satisfied, click **Generate** to create the new role.

<Frame caption="Create Role with custom permissions">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/EVv-IFlz-DsWmGpt/images/teams-quickstart-5.webp?fit=max&auto=format&n=EVv-IFlz-DsWmGpt&q=85&s=b55942ae412b6206a99f571097c7cc61" alt="" width="953" height="801" data-path="images/teams-quickstart-5.webp" />
</Frame>

For more information on Permission Groups and what they allow access to, [click here](/api-reference/permissions-and-authorization).

## Inviting Team Members

To invite a team member, go to the **Members Page** and click on the **Invite** button.

This will bring up a quick popup where you can enter the email and team role for the person you want to invite. Once complete, click **Invite** to send the invitation email.

<Frame caption="Invite Member">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/EVv-IFlz-DsWmGpt/images/teams-quickstart-6.webp?fit=max&auto=format&n=EVv-IFlz-DsWmGpt&q=85&s=6cf0d25bbf816aee3737c6fd96f13d30" alt="" width="800" height="605" data-path="images/teams-quickstart-6.webp" />
</Frame>

Once you send the invitation, the user should get an email asking them to join your team. Upon clicking the link in the email they will be added as a member of your team.

**Note:** if the recipient of the invitation does not have a Vast account, they will need to create one before being added to your Team.

Once the invitee has joined your team, you should see them listed in the **Members** section.

<Frame caption="Team Members">
  <img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/EVv-IFlz-DsWmGpt/images/teams-quickstart-7.webp?fit=max&auto=format&n=EVv-IFlz-DsWmGpt&q=85&s=80a7dd3e6fa32fe992d3affb91b8a8f0" alt="" width="1171" height="512" data-path="images/teams-quickstart-7.webp" />
</Frame>

## Using SSH Keys with Team Instances

If you are part of a **team** and want to connect to a **team’s instance** using SSH, simply add your key to your individual account keys. Here’s how it works depending on the type of instance:

🔹 VM Instances

* Your SSH key **must be added to your personal account before the VM is created**.
* When the VM is launched, all SSH keys in your account are automatically included for access a team instance.

🔹 Non-VM Instances

* You can either:
  * **Add your SSH key directly to the instance**, or
  * **Add your key to your personal account**, in which case it will be automatically applied to the team instance as well.

<img src="https://mintcdn.com/vastai-80aa3a82-ltxv2-serverless/raWWQ-_K1M8Puobr/images/Screenshot2025-09-08171421.png?fit=max&auto=format&n=raWWQ-_K1M8Puobr&q=85&s=3ac36d466d50333407051f587ac93496" alt="Screenshot2025 09 08171421 Pn" width="1016" height="249" data-path="images/Screenshot2025-09-08171421.png" />

## Conclusion

You have now successfully created a team!

From this point, you can add any Billing information the same way as a regular account and invite as many of your teammates as you like so you can collaborate together with ease.
