> ## Documentation Index
> Fetch the complete documentation index at: https://openmetadata-docs-release-watchers.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Deployment | OpenMetadata Installation & Setup Guide

> Deploy, configure, and manage OpenMetadata across environments with security and scaling guidance.

<div className="deployment-page-container">
  # From 0 to OpenMetadata in 5 minutes

  We support different kinds of deployment:

  <Tabs className="deployment-tabs">
    <Tab title="Quick Start" icon="https://mintcdn.com/openmetadata-docs-release-watchers/R6CaBY8S5pWTKhnk/public/images/homepage-icons/quick-start.svg?fit=max&auto=format&n=R6CaBY8S5pWTKhnk&q=85&s=a4ae7f2e6299eca2bc2fbb1abf848e97" width="62" height="62" data-path="public/images/homepage-icons/quick-start.svg">
      ## Quick Start

      Choose how you want to try OpenMetadata

      <div className="card-layout">
        <div>
          <img noZoom src="https://mintcdn.com/openmetadata-docs-release-watchers/ezdiKQz5q6CP7kJI/public/images/deployment/quick-start/try-sandbox.svg?fit=max&auto=format&n=ezdiKQz5q6CP7kJI&q=85&s=76953d8f907f85082c6167cc99343383" alt="Try Sandbox" className="icon" width="45" height="45" data-path="public/images/deployment/quick-start/try-sandbox.svg" />
        </div>

        <div>
          <div className="header-container">
            <div className="header">Try Sandbox</div>
            <div className="header-chip">No setup · Hosted · Instant access</div>
          </div>

          <p>Explore OpenMetadata instantly with a hosted sandbox that mimics a real production setup  no installation required.</p>
        </div>

        <div>
          <a href="/v2.1.x-SNAPSHOT/quick-start/sandbox" className="button-card">Try Sandbox</a>
        </div>
      </div>

      <div className="card-layout">
        <div>
          <img noZoom src="https://mintcdn.com/openmetadata-docs-release-watchers/ezdiKQz5q6CP7kJI/public/images/deployment/quick-start/docker.svg?fit=max&auto=format&n=ezdiKQz5q6CP7kJI&q=85&s=94aebebd041e48693ed0e057a971f597" alt="Docker" className="icon" width="45" height="45" data-path="public/images/deployment/quick-start/docker.svg" />
        </div>

        <div>
          <div className="header-container">
            <div className="header">Run locally with Docker</div>
            <div className="header-chip">Local setup · Full control · Docker-based</div>
          </div>

          <p>Run OpenMetadata on your machine using Docker to get a hands-on experience with a real deployment.</p>

          <ul>
            <li>Prepare your environment with Docker and Docker Compose</li>
            <li>Launch OpenMetadata locally using the provided Docker Compose setup</li>
            <li>Operate and troubleshoot the deployment via UI and Docker commands</li>
          </ul>
        </div>

        <div>
          <a href="/v2.1.x-SNAPSHOT/quick-start/local-docker-deployment" className="button-link">Learn More <img src="https://mintcdn.com/openmetadata-docs-release-watchers/R6CaBY8S5pWTKhnk/public/images/homepage-icons/right-arrow.svg?fit=max&auto=format&n=R6CaBY8S5pWTKhnk&q=85&s=b5ab0292a584e81b95f101432a3f706d" alt="Right arrow" width="14" height="14" data-path="public/images/homepage-icons/right-arrow.svg" /></a>
        </div>
      </div>
    </Tab>

    <Tab title="Production" icon="https://mintcdn.com/openmetadata-docs-release-watchers/R6CaBY8S5pWTKhnk/public/images/homepage-icons/production.svg?fit=max&auto=format&n=R6CaBY8S5pWTKhnk&q=85&s=4a74ba4279acefa79c08d2a285e322ae" width="62" height="62" data-path="public/images/homepage-icons/production.svg">
      ## Production

      Deploy OpenMetadata securely and reliably for team and organization use.

      <Columns cols={3}>
        <Card title="AWS Kubernetes (EKS)" icon="https://mintcdn.com/openmetadata-docs-release-watchers/HWbno6XxqSArVghO/public/images/deployment/production/eks.svg?fit=max&auto=format&n=HWbno6XxqSArVghO&q=85&s=10e7b25949845e39a213fd8056472ce6" href="/v2.1.x-SNAPSHOT/deployment/kubernetes/eks" cta="Learn More" width="45" height="45" data-path="public/images/deployment/production/eks.svg">
          Deploy OpenMetadata on AWS using Amazon EKS and AWS-managed services for production workloads.
        </Card>

        <Card title="Azure Kubernetes (AKS)" icon="https://mintcdn.com/openmetadata-docs-release-watchers/HWbno6XxqSArVghO/public/images/deployment/production/aks.png?fit=max&auto=format&n=HWbno6XxqSArVghO&q=85&s=6f88e9141cd64c921122607add770fb8" href="/v2.1.x-SNAPSHOT/deployment/kubernetes/aks" cta="Learn More" width="106" height="90" data-path="public/images/deployment/production/aks.png">
          Run OpenMetadata on Azure Kubernetes with Azure-native database and search services.
        </Card>

        <Card title="Google Kubernetes Engine(GKE)" icon="https://mintcdn.com/openmetadata-docs-release-watchers/HWbno6XxqSArVghO/public/images/deployment/production/gke.svg?fit=max&auto=format&n=HWbno6XxqSArVghO&q=85&s=265cf7f49f4dae234f7a7c5828809d06" href="/v2.1.x-SNAPSHOT/deployment/kubernetes/gke" cta="Learn More" width="41" height="45" data-path="public/images/deployment/production/gke.svg">
          Deploy OpenMetadata on Google Cloud using GKE with managed infrastructure and services.
        </Card>

        <Card title="On-Premises Kubernetes" icon="https://mintcdn.com/openmetadata-docs-release-watchers/ezdiKQz5q6CP7kJI/public/images/deployment/production/on-prem-kubernetes.png?fit=max&auto=format&n=ezdiKQz5q6CP7kJI&q=85&s=ec3bb26cabb9ec6cd806c5baaaba956c" href="/v2.1.x-SNAPSHOT/deployment/kubernetes/on-prem" cta="Learn More" width="56" height="52" data-path="public/images/deployment/production/on-prem-kubernetes.png">
          Deploy OpenMetadata on a self-managed, on-premises Kubernetes cluster.
        </Card>

        <Card title="Kubernetes Deployment" icon="https://mintcdn.com/openmetadata-docs-release-watchers/ezdiKQz5q6CP7kJI/public/images/deployment/production/kubernetes.png?fit=max&auto=format&n=ezdiKQz5q6CP7kJI&q=85&s=1e9dcb868cc30286b0aeaf447388c282" href="/v2.1.x-SNAPSHOT/deployment/kubernetes" cta="Learn More" width="94" height="92" data-path="public/images/deployment/production/kubernetes.png">
          Deploy OpenMetadata on Kubernetes using Helm charts for a scalable, production-ready setup.
        </Card>

        <Card title="Bare Metal Deployment" icon="https://mintcdn.com/openmetadata-docs-release-watchers/HWbno6XxqSArVghO/public/images/deployment/production/bare-metal.svg?fit=max&auto=format&n=HWbno6XxqSArVghO&q=85&s=1dc77a582a3b72b5c6291a1a4ccb83c9" href="/v2.1.x-SNAPSHOT/deployment/bare-metal" cta="Learn More" width="45" height="45" data-path="public/images/deployment/production/bare-metal.svg">
          Install and run OpenMetadata directly on physical or self-managed servers without Kubernetes.
        </Card>
      </Columns>

      ## Production Configuration & Hardening

      <div className="card-layout">
        <div>
          <img noZoom src="https://mintcdn.com/openmetadata-docs-release-watchers/ezdiKQz5q6CP7kJI/public/images/deployment/production/production-ready.svg?fit=max&auto=format&n=ezdiKQz5q6CP7kJI&q=85&s=378f310a25837ecae1fc25bd7f9f1dfb" alt="Production Ready" className="icon" width="45" height="45" data-path="public/images/deployment/production/production-ready.svg" />
        </div>

        <div>
          <div className="header-container">
            <div className="header">Production Ready Requirements</div>
          </div>

          <p>Understand hardware sizing, performance, and infrastructure requirements for production deployments.</p>
        </div>

        <div>
          <a href="/v2.1.x-SNAPSHOT/deployment/production-ready-requirements" className="button-link">Learn More <img src="https://mintcdn.com/openmetadata-docs-release-watchers/R6CaBY8S5pWTKhnk/public/images/homepage-icons/right-arrow.svg?fit=max&auto=format&n=R6CaBY8S5pWTKhnk&q=85&s=b5ab0292a584e81b95f101432a3f706d" alt="Right arrow" width="14" height="14" data-path="public/images/homepage-icons/right-arrow.svg" /></a>
        </div>
      </div>

      <div className="card-layout">
        <div>
          <img noZoom src="https://mintcdn.com/openmetadata-docs-release-watchers/HWbno6XxqSArVghO/public/images/deployment/production/enable-security.svg?fit=max&auto=format&n=HWbno6XxqSArVghO&q=85&s=804444719309d2eebc46d699c2281d75" alt="Enable Security" className="icon" width="45" height="45" data-path="public/images/deployment/production/enable-security.svg" />
        </div>

        <div>
          <div className="header-container">
            <div className="header">Enable Security</div>
          </div>

          <p>Secure your OpenMetadata deployment with authentication, authorization, and secrets management.</p>
        </div>

        <div>
          <a href="/v2.1.x-SNAPSHOT/deployment/security" className="button-link">Learn More <img src="https://mintcdn.com/openmetadata-docs-release-watchers/R6CaBY8S5pWTKhnk/public/images/homepage-icons/right-arrow.svg?fit=max&auto=format&n=R6CaBY8S5pWTKhnk&q=85&s=b5ab0292a584e81b95f101432a3f706d" alt="Right arrow" width="14" height="14" data-path="public/images/homepage-icons/right-arrow.svg" /></a>
        </div>
      </div>
    </Tab>

    <Tab title="Upgrade" icon="https://mintcdn.com/openmetadata-docs-release-watchers/R6CaBY8S5pWTKhnk/public/images/homepage-icons/upgrade.svg?fit=max&auto=format&n=R6CaBY8S5pWTKhnk&q=85&s=32726252430b59c4642399f53a6949ab" width="62" height="62" data-path="public/images/homepage-icons/upgrade.svg">
      ## Upgrade

      Before upgrading, review compatibility requirements and back up your metadata.

      <div className="card-layout upgrade">
        <div>
          <img noZoom src="https://mintcdn.com/openmetadata-docs-release-watchers/i1TjhksueR2B7X3s/public/images/deployment/upgrade/upgrade-om.svg?fit=max&auto=format&n=i1TjhksueR2B7X3s&q=85&s=661e78541c68cc85d0c3287af1d1fb81" alt="Upgrade OM" className="icon" width="45" height="45" data-path="public/images/deployment/upgrade/upgrade-om.svg" />
        </div>

        <div>
          <div className="header-container">
            <div className="header">Upgrade OpenMetadata</div>
          </div>

          <p>Safely upgrade your OpenMetadata deployment to the latest supported version with pre-checks and post-upgrade validation.</p>
        </div>

        <div>
          <a href="/v2.1.x-SNAPSHOT/deployment/upgrade" className="button-link">Learn More <img src="https://mintcdn.com/openmetadata-docs-release-watchers/R6CaBY8S5pWTKhnk/public/images/homepage-icons/right-arrow.svg?fit=max&auto=format&n=R6CaBY8S5pWTKhnk&q=85&s=b5ab0292a584e81b95f101432a3f706d" alt="Right arrow" width="14" height="14" data-path="public/images/homepage-icons/right-arrow.svg" /></a>
        </div>
      </div>

      <Columns cols={2}>
        <Card title="Upgrade Compatibility & Requirements" icon="https://mintcdn.com/openmetadata-docs-release-watchers/i1TjhksueR2B7X3s/public/images/deployment/upgrade/upgrade-compatibility.svg?fit=max&auto=format&n=i1TjhksueR2B7X3s&q=85&s=ba891722cd753c8583b1a68cdbad33e3" href="/v2.1.x-SNAPSHOT/deployment/upgrade/kubernetes" cta="Learn More" width="45" height="45" data-path="public/images/deployment/upgrade/upgrade-compatibility.svg">
          Understand supported upgrade paths, breaking changes, and version compatibility.
        </Card>

        <Card title="Backup & Restore Metadata" icon="https://mintcdn.com/openmetadata-docs-release-watchers/CXznGRDqbPj1aZ8M/public/images/deployment/upgrade/backup-restore-metadata.svg?fit=max&auto=format&n=CXznGRDqbPj1aZ8M&q=85&s=2e207d932462ca4d66a26160e63529bd" href="/v2.1.x-SNAPSHOT/deployment/backup-restore-metadata" cta="Learn More" width="45" height="45" data-path="public/images/deployment/upgrade/backup-restore-metadata.svg">
          Back up your metadata before upgrading and restore it if needed.
        </Card>
      </Columns>
    </Tab>
  </Tabs>
</div>