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

# Migrate Existing Repositories

> Seamlessly migrate an existing Revolte application to a new repository source without impacting active deployments, configurations, environments, or historical operational data.

## Migration Workflow

Execute a secure migration in six steps:

<Steps>
  <Step title="Navigate to organization settings">
    Select your **Profile** icon and click your active organization in the Revolte Console.
  </Step>

  <Step title="Open general settings">
    Navigate to the **General Settings** tab to locate the **Repository Migration** module.
  </Step>

  <Step title="Initiate migration">
    Click the **Migrate** button to initialize the source-linking wizard.
  </Step>

  <Step title="Authenticate connection">
    Provide your version control provider's Personal Access Token (PAT) with appropriate repository and pipeline scopes.
  </Step>

  <Step title="Select target repository">
    Verify the active project and application context, and choose your destination repository from the dynamic dropdown menu.
  </Step>

  <Step title="Confirm migration">
    Click **Confirm migration**. Future codebase triggers, deployments, and preview environments will track and build commits from the new repository source immediately.
  </Step>
</Steps>

***

## Reference

### FAQ

<AccordionGroup>
  <Accordion title="Will migrating a repository cause deployment downtime?">
    No. Active deployments are completely unaffected. Running services continue to serve traffic, and subsequent builds automatically compile from the new repository source.
  </Accordion>

  <Accordion title="What happens to historical logs, metrics, and DORA telemetry?">
    All application history remains completely intact. Deployment tracking, security logs, and historical DORA insights persist within the active Revolte application dashboard.
  </Accordion>
</AccordionGroup>

### Support Policy

Need assistance migrating business-critical services? Connect directly with the operations team on our [Contact Page](https://revolte.ai/contact) or reach out to your technical account manager.