# Git

Since IDA 9.4, Teams includes Git integration, bringing familiar version control workflows to collaborative reverse engineering. **Git-based repositories are recommended for new Teams projects.**

{% hint style="success" %}
Using Vault already? See the [Vault to Git Migration](/9.4/add-ons/teams/how-tos/migrating-from-vault-to-git.md) tutorial to get started.
{% endhint %}

The Git backend removes the need for a dedicated Teams server (previously known as the *Hex-Rays Vault* server). If your team already has a Git provider account, such as GitHub, GitLab, or any self-hosted instance, that's all you need: no dedicated Teams server installation, no admin provisioning, and no additional credential management. Every user authenticates with their own Git account, points IDA at a repository, and starts collaborating immediately.

![Teams menu with Git backend](/files/keenCfpR0cUeGQAG5zZw)

## Prerequisites

* IDA Pro 9.4 installed and an active IDA license with Teams add-on

## Setup

Before using the Git backend commands under the **Teams** menu, complete the following steps:

1. **Install Git.** `git-ida` ships with IDA and is picked up automatically from IDA's `tools/teams` directory. You only need a system-wide Git installation. If Git is missing, IDA will tell you when you trigger a Git action.
2. **Set up a repository** for the IDB you want to work with:
   * **Teams → Create Repository** — turns the directory containing the current IDB into a new Git repository. Optionally, link it to an empty remote URL at this step.
   * **Teams → Clone Repository** — downloads an existing shared repository to a folder of your choice.
3. **Set your Git identity** (user name + email). On your first commit, IDA opens the *Repository Settings* dialog so you can set them. If you already have a global `user.name` / `user.email` configured, IDA picks them up automatically.

{% hint style="info" %}
For HTTPS remotes, IDA will prompt you for credentials the first time they are needed and store them securely in the OS keychain.
{% endhint %}

## What's Next?

You're ready to collaborate on your IDB. See [Working with Git](/9.4/add-ons/teams/how-tos/working-with-git.md) for day-to-day operations: committing, pushing, pulling, viewing history, and resolving conflicts.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hex-rays.com/9.4/add-ons/teams/getting-started/getting-started-git.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.