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

# Use with self-hosted CodeRabbit

> Connect the VS Code extension to your self-hosted CodeRabbit instance for on-premises code reviews with full data control.

Configure the CodeRabbit VS Code extension to work with your organization's self-hosted CodeRabbit instance. This setup gives you all the benefits of AI-powered code reviews while maintaining full control over your code and data.

<Tip>
  Using CodeRabbit's managed service instead? See [Install the VS Code
  extension](/ide/vscode-install) for the standard setup process.
</Tip>

## Prerequisites

Before connecting to your self-hosted instance, ensure:

<CardGroup cols={2}>
  <Card title="Extension version" icon="download">
    CodeRabbit extension version `0.12.1` or higher installed in your editor
  </Card>

  <Card title="Clean setup" icon="log-out">
    Log out of the extension if you were previously connected to the managed
    service
  </Card>
</CardGroup>

## Connect your self-hosted instance

<Steps>
  <Step title="Access self-hosted option">
    Click on the "Self hosting CodeRabbit?" button, located below the "Use
    CodeRabbit for free" button.
  </Step>

  <Step title="Configure instance URL">
    Enter your self-hosted instance URL when prompted.

    <Note>
      Make sure the instance URL is reachable within your network and websocket
      connections are allowed.
    </Note>
  </Step>

  <Step title="Select git provider and authenticate">
    Select your git provider: GitLab, Self-Hosted GitLab, GitHub, or GitHub
    Enterprise. If using GitHub or GitHub Enterprise, enter your [GitHub
    Personal Access
    Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)
    when prompted.
  </Step>
</Steps>

You should now be connected to your self-hosted instance and ready to use the VS Code extension.

## Next steps

<CardGroup cols={1}>
  <Card title="Use the VS Code extension" href="/ide/vscode-use" icon="play">
    Learn how to trigger reviews, apply fixes, and integrate with your
    development workflow.
  </Card>

  <Card title="Configure the VS Code extension" href="/ide/vscode-config" icon="settings">
    Customize extension settings, review preferences, and integration options.
  </Card>

  <Card title="Uninstall the VS Code extension" href="/ide/vscode-uninstall" icon="trash">
    Remove the extension if you no longer need it or want to switch setups.
  </Card>
</CardGroup>