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

# Setup guide - Hybrid SaaS Databricks on Azure

export const m_runner = "Maia runner";

export const maia = "Maia";

This document describes the necessary steps to follow to set up your first working project in {maia} for the following configuration options:

<div class="metadata-grid" data-search-exclude>
  <div class="metadata-label">Deployment type:</div>

  <div class="metadata-value">
    <span class="cdp">Hybris SaaS</span>
  </div>

  <div class="metadata-label">Cloud platform:</div>

  <div class="metadata-value">
    <span class="cdp">Azure</span>
  </div>

  <div class="metadata-label">Cloud data warehouse:</div>

  <div class="metadata-value">
    <span class="cdp">Databricks</span>
  </div>
</div>

***

## Video example

Expand this box to watch our video on how to setup Hybrid SaaS on Azure.

<Accordion title="Video">
  <p style={{textAlign: "center"}}>
    <iframe width="560" height="315" src="https://www.youtube.com/embed/kBnSxRBp9zE?si=l3kMQwrx0tAkeySs&enablejsapi=1" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share; fullscreen" referrerPolicy="strict-origin-when-cross-origin" allowFullScreen />
  </p>
</Accordion>

***

## Prerequisites

### Azure requirements

* An [Azure](https://learn.microsoft.com/en-us/azure/azure-portal/) subscription with appropriate permissions to provision cloud resources in the Azure environment and manage access control, specifically for managing:
  * Resource groups.
  * Virtual networks.
  * Key vaults.
  * Container apps.
* A suitable [resource group](https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/manage-resource-groups-portal) already defined in your Azure environment.
* A suitable [virtual network](https://learn.microsoft.com/en-us/azure/virtual-network/) already defined in your Azure environment. The virtual network must:
  * Be fully configured, including routing to on-premises resources.
  * Allow egress to Matillion's [{maia} IP ranges](/docs/security/network-access-and-ip-allowlist-requirements).
  * Have room for one additional subnet with at least `/27` IP range.
* A suitable [key vault](https://learn.microsoft.com/en-us/azure/key-vault/). You can use an existing key vault or a new one will be created as part of the setup process.
* Minimum permissions to include the following:
  * Create subnet.
  * Create managed identity.
  * Create key vault.
  * Create log analytics workspace.
  * Create container app and container app environment.
  * Modify subnet delegation.
* [Role](https://learn.microsoft.com/en-us/azure/role-based-access-control/overview) assignments in the resource group and key vault.

### Databricks requirements

* A [Databricks](https://www.databricks.com/) account with the following information:
  * Your Databricks [instance name](https://learn.microsoft.com/en-gb/azure/databricks/workspace/workspace-details).
  * Your Databricks [personal access token](https://docs.databricks.com/en/dev-tools/auth/pat.html).

### Connectivity requirements

* Access enabled for the IP addresses listed under the **Hybrid SaaS** section of [Network access and IP Allowlist requirements](/docs/security/network-access-and-ip-allowlist-requirements/#hybrid-saas-agents-and-git-repositories).

### Git requirements

If you choose to use [your own Git provider](/docs/guides/installing-git-provider-overview) instead of the Matillion-hosted Git option, you need the following:

* The Matillion Git app installed in your organization's account with one of the supported Git providers:
  * [GitHub](/docs/guides/installing-matillion-app-github-marketplace).
  * [Azure DevOps](/docs/guides/installing-matillion-app-azure-devops).
  * [GitLab](/docs/guides/connect-gitlab-repository-prerequisites).
  * [Bitbucket](/docs/guides/connect-bitbucket-repository-prerequisites).

***

## Setup steps

1. Register for a [{maia} account](/docs/administration/registration).
2. [Create accounts](/docs/administration/manage-accounts) for users and admins who will be active in {maia}.
3. [Create a {m_runner}](/docs/guides/create-a-runner) in {maia}.
4. Deploy a Container App {m_runner} in Azure using the recommended [ARM template](/docs/guides/azure-arm-runner-install).
5. Create a [project](/docs/guides/projects#add-a-new-project), making the following choices:
   * Select **Advanced settings**.
   * Select the {m_runner} you created and deployed previously.
   * Select the Git provider you wish to use.
6. Create an [environment](/docs/guides/environments) using your Databricks credentials.
7. Set up [secret definitions](/docs/guides/secrets-and-secret-definitions#add-a-secret-definition-hybrid-saas) for passwords, API keys, and tokens.
8. Create a Git [branch](/docs/guides/branches) in which to begin pipeline work.
9. Create your first [pipeline](/docs/guides/pipelines).