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

# Migrate to Microsoft Foundry

> Move an Azure OpenAI or Azure AI Foundry account to the Microsoft Foundry integration in TrueFoundry.

Microsoft Foundry is the new provider integration that replaces the Azure OpenAI and Azure AI Foundry integrations. It follows Microsoft's direction to unify its AI services under a single Foundry resource. It is generally available in **TrueFoundry v0.175.0**.

Migrating takes two parts: [update the resource in Azure](#part-1-update-the-resource-in-azure), then [create a Microsoft Foundry provider account in TrueFoundry](#part-2-create-a-microsoft-foundry-account-in-truefoundry).

## Part 1: Update the resource in Azure

### Hub and hub-based resources

A hub or hub-based project cannot be migrated. The Microsoft Foundry integration does not support these resources.

### Azure AI Foundry resources

This path is for an Azure AI Foundry account whose Azure resource is a Foundry resource, not a hub.

**1. Open the account overview**

In the Azure Portal, open the list of resources and click on the resource of type **Foundry**. Then, click on **Overview**.

![Selecting the right resource in the Azure Portal](https://mintcdn.com/truefoundry/azJhJKx5fXUK5Alg/images/docs/ai-gateway/see-all-resources-azure.png?fit=max\&auto=format\&n=azJhJKx5fXUK5Alg\&q=85\&s=2023026d9d3fa8bfd807155e2d370742)

**2. Turn on new Foundry**

Turn on the **new Foundry** toggle on the top panel of the screen.

**3. Add a project name**

Enter a project name if you want one. This step is optional.

![Creating project from existing Foundry resource](https://mintcdn.com/truefoundry/ZzHbA6zErxKhouTq/images/docs/ai-gateway/create-project-popup.png?fit=max\&auto=format\&n=ZzHbA6zErxKhouTq\&q=85\&s=5e569ba45f9f1cdd5492b81bb812cf55)

**4. Create**

Click on **Create**. It is now a project usable on the Microsoft Foundry provider account.

### Azure OpenAI resources

**1. Open the account overview**

In the Azure Portal, open the list of resources and click on the resource of type **Azure OpenAI**. Then, click on the option to open it in the Azure OpenAI portal.

![Selecting the right resource in the Azure Portal](https://mintcdn.com/truefoundry/azJhJKx5fXUK5Alg/images/docs/ai-gateway/see-all-resources-azure.png?fit=max\&auto=format\&n=azJhJKx5fXUK5Alg\&q=85\&s=2023026d9d3fa8bfd807155e2d370742)

**2. Start the upgrade**

Click on **Home**, and then click **Get Started** in the banner at the top of the page.

![Click on Get Started](https://mintcdn.com/truefoundry/ZzHbA6zErxKhouTq/images/docs/ai-gateway/Azure-openai-banner.png?fit=max\&auto=format\&n=ZzHbA6zErxKhouTq\&q=85\&s=2e060f18794e12641d47edd359f6e2f5)

**3. Follow the steps**

Complete the steps in the upgrade flow. When it finishes, the account is a Microsoft Foundry account.

## Part 2: Create a Microsoft Foundry account in TrueFoundry

Upgrading the resource in Azure does not change your existing Azure OpenAI or Azure AI Foundry provider account in TrueFoundry. Create a new Microsoft Foundry provider account for the upgraded resource.

**1. Create the provider account**

Add a Microsoft Foundry account with the resource's OpenAI endpoint, the project endpoint, and your authentication method. See [Add a Microsoft Foundry account](/docs/ai-gateway/microsoft-foundry#add-a-microsoft-foundry-account) for the full steps.

**2. Add or discover deployments**

Use [model discovery](/docs/ai-gateway/microsoft-foundry#discover-deployments) to import your deployments from the project endpoint, or add them manually.

**3. Point your applications at the new account**

Gateway model IDs use the format `<provider-account-name>/<integration-name>`. If you give the new account and its integrations the same names as the old ones, existing clients keep working unchanged. Otherwise, update the model IDs in your applications. See [Call a Microsoft Foundry model](/docs/ai-gateway/microsoft-foundry#call-a-microsoft-foundry-model).

**4. Remove the old account**

After you confirm requests work through the new account, remove the old Azure OpenAI or Azure AI Foundry provider account.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.