# OpenMetadata Documentation: v2.1.x-SNAPSHOT Deployment

## Deployment

### Deployment

- [Deployment | OpenMetadata Installation & Setup Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment.md): Deploy, configure, and manage OpenMetadata across environments with security and scaling guidance.
- [Minimum Requirements | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/minimum-requirements.md): Review system requirements including OS, CPU, memory, and dependencies to ensure a successful and stable deployment.
- [Enable Semantic Search | OpenMetadata Deployment Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/semantic-search.md): Configure semantic search with vector embeddings in OpenMetadata to enable natural language queries against your metadata catalog using OpenSearch or Elasticsearch.
- [Enable RDF (Knowledge Graph) (Beta) | OpenMetadata Deployment Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/rdf-knowledge-graph.md): Enable the RDF Knowledge Graph in OpenMetadata by deploying Apache Jena Fuseki and pointing the server at the triplestore.
- [How to enable AWS RDS IAM Auth  | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/iam-auth.md): Learn how to securely connect OpenMetadata to AWS RDS using IAM authentication with correct environment variables and configuration best practices.
- [How to enable Azure Auth](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/azure-auth.md)
- [Azure - Enable Passwordless Database Backend Connection](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/azure-passwordless-auth.md)
- [Production-Ready Requirements for OpenMetadata Deployment](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/production-ready-requirements.md)
- [Server Configuration Reference | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/configuration.md): Configure your platform deployment using environmental settings, secret values, service parameters, and performance tuning options.
- [Database Connection Pooling](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/database-connection-pooling.md): Optimize your OpenMetadata deployment with database connection pooling. Learn configuration best practices, performance tuning, and setup guides.
- [Backup Metadata | OpenMetadata Deployment Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/backup-restore-metadata.md): Back up and restore metadata to preserve lineage, classifications, descriptions, and governance data across updates or outages.
- [Metrics](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/metrics.md)
- [OSS Security Best Practices](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/oss-security.md)

#### Bare Metal Deployment

- [Bare Metal Deployment | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/bare-metal.md): Deploy the platform on bare-metal servers to maintain full control over infrastructure, authentication, and network configuration.
- [Enable Security | OpenMetadata Deployment Security Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/bare-metal/security.md): Secure bare-metal deployments with guidance on encryption, authentication, and secret management for non-cloud environments.
- [Configuring OpenMetadata to Run Under a Subpath](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/bare-metal/subpath.md)

#### Docker Deployment

- [Docker Deployment | OpenMetadata Container Setup](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/docker.md): Deploy the platform using Docker containers to simplify setup, scaling, and local testing without needing external dependencies.
- [Docker Advanced Configuration & Troubleshooting](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/docker/advanced.md): Configure port mapping, load balancing, AWS services, volumes, and troubleshoot common Docker deployment issues for OpenMetadata.
- [Enable Security (Docker) | OpenMetadata Docker Security](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/docker/security.md): Secure Docker-based deployments using best practices in network access, token handling, and identity provider integration.
- [Configuring OpenMetadata to Run Under a Subpath](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/docker/subpath.md)

#### Kubernetes Deployment

- [Kubernetes Deployment | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes.md): Deploy the OpenMetadata on Kubernetes using Helm, custom values, and supported cloud configurations for scalable containerized environments.
- [Kubernetes Helm Values | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/values.md): Customize your Helm values for Kubernetes deployments to control services, authentication, storage, and resource tuning.
- [AKS Deployment: Prerequisites & Kubernetes Orchestrator](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/aks.md): Configure OpenMetadata on Azure Kubernetes Service using the recommended Kubernetes-native orchestrator with Helm charts and scalable configuration templates.
- [AKS Deployment: Airflow Orchestrator & Troubleshooting](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/aks-airflow.md): Configure OpenMetadata on Azure Kubernetes Service using Apache Airflow as the ingestion orchestrator, including persistent volume setup and troubleshooting.
- [Enable Security](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/security.md)
- [Configuring OpenMetadata to Run Under a Subpath](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/subpath.md)

##### EKS Deployment

- [AWS EKS Deployment | OpenMetadata Kubernetes Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/eks.md): Deploy the OpenMetadata on Amazon EKS for cloud-native scalability with secure identity integration and managed infrastructure support.
- [Airflow Orchestrator on EKS | OpenMetadata Kubernetes Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/eks/airflow.md): Configure Apache Airflow as the orchestrator for OpenMetadata on Amazon EKS with EFS persistent storage.
- [Terraform AWS Deployment | OpenMetadata](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/eks/terraform.md): Deploy OpenMetadata on Amazon EKS using the official Terraform module with support for RDS, OpenSearch Service, and multiple provisioner modes.

##### GKE Deployment

- [Kubernetes GKE Deployment | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/gke.md): Run your deployment on Google Kubernetes Engine (GKE) for a reliable, managed Kubernetes experience with secure configurations.
- [GKE with Apache Airflow Orchestrator | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/gke/airflow.md): Configure Apache Airflow as the ingestion orchestrator on Google Kubernetes Engine with NFS persistent volumes and ReadWriteMany access.

##### On-Prem Deployment

- [Kubernetes On Premises Deployment | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/on-prem.md): Set up the OpenMetadata on-premises with Kubernetes for full control over infrastructure, security, and compliance requirements.
- [On-Prem Airflow Storage Setup | OpenMetadata Kubernetes Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/kubernetes/on-prem/airflow.md): Provision NFS-backed persistent volumes for Airflow DAGs and logs on on-premises Kubernetes and deploy OpenMetadata.

#### Ingestion

- [Ingestion Framework Deployment | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion.md): Configure ingestion from external, cloud-native, or hybrid environments using deployment guides.

##### OpenMetadata Ingestion

- [Run the ingestion from the OpenMetadata UI](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/openmetadata.md): Learn how to deploy and configure OpenMetadata Ingestion pipelines. Complete setup guide with connectors, scheduling, and best practices.
- [Airflow Troubleshooting & Advanced | OpenMetadata Ingestion](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/openmetadata/troubleshooting.md): Validate your Airflow installation, configure Git Sync and SSL, and troubleshoot common ingestion pipeline deployment issues.

##### Kubernetes Orchestrator

- [Kubernetes Native Orchestrator](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/kubernetes.md): Run ingestion pipelines using native Kubernetes Jobs and CronJobs without requiring Apache Airflow.
- [Kubernetes Orchestrator Operations & Troubleshooting](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/kubernetes/troubleshooting.md): Validate, monitor, and troubleshoot the Kubernetes native orchestrator for OpenMetadata ingestion pipelines.

##### External

- [Run the ingestion from your Airflow](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/external/airflow.md): Deploy ingestion externally using Airflow for scalable orchestration of metadata pipelines across environments.
- [Airflow Docker & Virtualenv Operators | OpenMetadata Ingestion](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/external/airflow-docker-virtualenv.md): Run OpenMetadata ingestion workflows in Airflow using the Docker Operator or Python Virtualenv Operator for isolated, dependency-free execution.
- [Run the ingestion from GCP Composer  | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/external/gcp-composer.md): Deploy external ingestion using GCP Composer to automate metadata and quality pipelines on Google Cloud environments.
- [Run the ingestion from GitHub Actions](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/external/github-actions.md): Configure GitHub Actions for metadata ingestion to run workflows on commits, schedules, or triggers in your CI/CD pipelines.
- [Managing Credentials](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/external/credentials.md)
- [Using Airflow Connections for Credentials](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/external/credentials-airflow.md): Retrieve and use Airflow Connections to securely pass service credentials in OpenMetadata ingestion pipelines.

###### External Ingestion

- [Run the Ingestion Framework Externally](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/external.md): Configure external ingestion endpoints to trigger metadata pipelines from orchestrators or custom scripts.
- [External Ingestion Workflow Examples](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/external/examples.md): Code examples for running OpenMetadata ingestion workflows externally — metadata, lineage, usage, profiler, and data quality.

###### AWS MWAA

- [Run the ingestion from AWS MWAA | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/external/mwaa.md): Integrate with MWAA to schedule and execute ingestion workflows using managed Airflow on AWS infrastructure.
- [MWAA Ingestion with Python VirtualenvOperator | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/ingestion/external/mwaa/virtualenv.md): Configure the PythonVirtualenvOperator in AWS MWAA for isolated ingestion workflow execution without library conflicts.

#### Enable Security

- [Enable Security | OpenMetadata Deployment Security](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security.md): Learn about authentication, encryption, secret management, and provider configurations for securing your platform deployment.
- [Basic Authentication | OpenMetadata Security Setup](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/basic-auth.md): Configure Basic Auth to secure service access with username and password authentication for lightweight, internal use cases.
- [OIDC Based Authentication | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/oidc.md): Enable OIDC-based authentication to unify identity providers using open standards, access tokens, and flexible integration patterns.
- [Enable JWT Tokens | OpenMetadata Security Features](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/enable-jwt-tokens.md): Enable JWT-based security for user authentication, session management, and platform API access using tokens.
- [OIDC Based Authentication](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/configuration-parameters.md)
- [JWT validation Troubleshooting | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/jwt-troubleshooting.md): Fix JWT-based authentication issues with deployment and ingestion by adjusting token validation and decoding settings.

##### Ldap Authentication

- [LDAP Authentication | OpenMetadata Security Setup](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/ldap.md): Configure LDAP integration to support centralized identity management using directory-based authentication systems.
- [Ldap Authentication for Bare Metal](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/ldap/bare-metal.md)
- [Ldap Authentication for Docker | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/ldap/docker.md): Integrate LDAP-based authentication in Docker for centralized credential management and user access across containerized applications.
- [Ldap Authentication for Kubernetes](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/ldap/kubernetes.md)

##### Auth0 SSO

- [Auth0 SSO | OpenMetadata Security Integration](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/auth0.md): Set up Auth0 as an identity provider to manage secure, token-based authentication across web apps, APIs, and user-facing services.

##### Azure SSO

- [Azure SSO | OpenMetadata Authentication Integration](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/azure.md): Deploy Azure authentication to manage secure token-based access and identity roles in cloud-native or hybrid environments.

##### Custom OIDC SSO

- [Custom OIDC SSO | OpenMetadata Security Integration](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/custom-oidc.md): Set up a custom OIDC provider for authentication, allowing flexible federation and secure access across deployments.

##### Google SSO

- [Google SSO | OpenMetadata Authentication Integration](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/google.md): Set up Google OAuth as your identity provider to enable secure login, token exchange, and scoped user access in deployments.

##### Okta SSO

- [Okta SSO | OpenMetadata Authentication Integration](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/okta.md): Configure Okta as your authentication provider to support secure login, identity federation, and enterprise-grade access control.

##### Amazon Cognito SSO

- [Amazon Cognito SSO | OpenMetadata Authentication Setup](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/amazon-cognito-sso.md): Enable Amazon Cognito for managing user authentication, token issuance, and identity pools in distributed or serverless systems.

##### One Login SSO

- [OneLogin SSO | OpenMetadata Authentication Setup](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/one-login.md): Configure OneLogin as your authentication source to manage user roles, sessions, and tokens across secure deployments.
- [One Login SSO for Docker | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/one-login/docker.md): Deploy OneLogin authentication in Docker for fast, secure user validation and centralized identity management in container services.
- [OneLogin SSO for Bare Metal | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/one-login/bare-metal.md): Use OneLogin authentication on bare-metal deployments to ensure secure, token-driven access without relying on cloud-native services.
- [OneLogin SSO for Kubernetes | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/one-login/kubernetes.md): Integrate OneLogin into Kubernetes clusters to securely manage authentication, access tokens, and identity roles at runtime.

##### Keycloak SSO

- [Keycloak SSO | OpenMetadata Security Integration](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/keycloak.md): Use Keycloak as your authentication server to centralize identity management with support for OIDC and SSO integrations.
- [Keycloak SSO for Docker](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/keycloak/docker.md)
- [Keycloak SSO for Bare Metal](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/keycloak/bare-metal.md)
- [Keycloak SSO for Kubernetes](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/keycloak/kubernetes.md)
- [Fix PKI Not Found When Using Keycloak with Custom PKI](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/keycloak/troubleshooting.md): Learn how to resolve PKI not found errors in OpenMetadata when using Keycloak behind Nginx with custom PKI by importing CA certificates into the truststore.

##### Saml

- [SAML SSO](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/saml.md)
- [SAML AWS SSO](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/saml/aws.md)
- [SAML AZURE SSO](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/saml/azure.md)

##### Enable SSL

- [Enable SSL | OpenMetadata Security Configuration](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/enable-ssl.md): Enable SSL to secure platform communication, data transfers, and authentication across endpoints and services.
- [Enable SSL with Nginx | OpenMetadata Security Setup](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/enable-ssl/nginx.md): Enable SSL using NGINX to encrypt traffic and protect sensitive metadata exchanges across service endpoints and UI access.
- [Enable SSL at the OpenMetadata Server](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/enable-ssl/openmetadata-server.md): Configure SSL for the OpenMetadata server to enable HTTPS, protect authentication flows, and secure backend communications.
- [Enable SSL in Airflow | OpenMetadata Security Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/enable-ssl/airflow-ssl.md): Enable SSL for Airflow-based deployments to secure metadata transport, authentication, and configuration endpoints.
- [SSL Troubleshooting | OpenMetadata Security Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/security/enable-ssl/ssl-troubleshooting.md): Troubleshoot SSL errors and misconfigurations affecting secure access to services, ingestion, and the UI.

#### Enable Secrets Manager

- [Enable Secrets Manager | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/secrets-manager.md): Learn how to manage secrets and credentials used by connectors and services through centralized secrets manager setup.
- [Secrets Manager](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/secrets-manager/how-to-add-a-new-implementation.md)

##### Supported Implementations

- [Secrets Manager | OpenMetadata Deployment Integration](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/secrets-manager/supported-implementations.md): Review supported secrets manager implementations to securely manage sensitive credentials across cloud and hybrid environments.
- [AWS Secrets Manager](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/secrets-manager/supported-implementations/aws-secrets-manager.md): Use AWS Secrets Manager to integrate secret storage with your OpenMetadata, supporting encrypted access to service credentials.
- [AWS Systems Manager Parameter Store](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/secrets-manager/supported-implementations/aws-ssm-parameter-store.md): Set up AWS SSM Parameter Store for secrets management to store and retrieve credentials securely in your deployment.
- [Azure Key Vault | OpenMetadata Secrets Manager Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/secrets-manager/supported-implementations/azure-key-vault.md): Get started with azure key vault. Setup instructions, features, and configuration details inside. Refer to the official documentation for the latest updates.
- [GCP Secret Manager Parameter Store | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/secrets-manager/supported-implementations/gcp-secret-manager.md): Connect Gcp Secret Manager to enable streamlined access, monitoring, or search of enterprise data using secure and scalable integrations.
- [Kubernetes Secrets Manager](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/secrets-manager/supported-implementations/kubernetes-secrets-manager.md): Use Kubernetes Secrets to integrate secret storage with your OpenMetadata, supporting secure access to service credentials.

#### Upgrade OpenMetadata

- [Upgrade OpenMetadata | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade.md): Upgrade the platform version with step-by-step instructions on migration, compatibility, and new feature adoption.
- [How do the Upgrade & Backup work?](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/how-does-it-work.md): Understand how the upgrade system works with a version-aware approach to safely migrate platform components and configurations.
- [Upgrade on Kubernetes | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/kubernetes.md): Upgrade Kubernetes deployments efficiently using version-specific instructions, Helm values, and best practices for safe rollout.
- [Kubernetes Upgrade Troubleshooting](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/kubernetes-troubleshooting.md): Resolve common issues when upgrading OpenMetadata on Kubernetes, including Helm failures, MySQL pod errors, and PostgreSQL extension requirements.

##### Breaking Changes

- [Breaking Changes 1.13 to 2.0 | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/breaking-changes/overview.md): Complete component-level breakdown of the API, schema, ingestion, configuration and UI breaking changes between OpenMetadata 1.13 and 2.0.
- [Breaking Changes - API & Schema | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/breaking-changes/api-and-schema.md): Removed REST endpoints, changed request and response shapes, tightened validation and enum changes in OpenMetadata 2.0.
- [Breaking Changes - Discovery & Search | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/breaking-changes/discovery-and-search.md): The redesigned OpenMetadata 2.0 Explore page, the new browse-and-filter query bar, changed URL parameters, facet scoping, staged ranking and async CSV export.
- [Breaking Changes - Collaboration | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/breaking-changes/collaboration.md): The OpenMetadata 2.0 Task redesign, removal of the Suggestions API, standalone Announcements, the ephemeral Activity Stream and alert filter changes.
- [Breaking Changes - Data Governance | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/breaking-changes/data-governance.md): Policies and new task operations, glossary and ontology, classification, governance workflows, Data Access Requests and the Policy Agent in OpenMetadata 2.0.
- [Breaking Changes - Data Quality | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/breaking-changes/data-quality.md): Incidents as Tasks, inlined incident status, incident auto-close, multi-status filters, batch DQ reporting and the removed Data Insights data quality module in OpenMetadata 2.0.
- [Breaking Changes - Lineage | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/breaking-changes/lineage.md): FQN-based lineage edge APIs, batch hydration, time-window traversal semantics and lineage change events in OpenMetadata 2.0.
- [Breaking Changes - Ingestion & Connectors | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/breaking-changes/ingestion-and-connectors.md): pipelineStatuses shape change, Databricks Pipeline authentication, Great Expectations 1.x, the log-stream SSE contract and new connectors in OpenMetadata 2.0.
- [Breaking Changes - Applications & Automation | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/breaking-changes/applications-and-automation.md): Search Indexing app config removals, RDF Index app defaults, Data Insights module config, MCP tool contracts and CSV background jobs in OpenMetadata 2.0.
- [Breaking Changes - Platform, Config & Security | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/breaking-changes/platform-and-security.md): llmConfiguration, database-backed sessions and concurrent-session limits, openmetadata.yaml changes and the 2.0.0 database migration.
- [Breaking Changes - UI & Customization | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/breaking-changes/ui-and-customization.md): Design-system consolidation, App Mode, persona preferences, Context Center and removed UI components in OpenMetadata 2.0.

##### Bare Metal Upgrade

- [Upgrade on Bare Metal | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/bare-metal.md): Learn how to upgrade deployments on bare-metal infrastructure with versioning steps, rollback plans, and configuration tips.
- [Bare Metal Upgrade Steps | Official Documentation](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/bare-metal/steps.md): Step-by-step upgrade process for OpenMetadata on bare-metal infrastructure, including database migration and post-upgrade tasks.

##### Docker Upgrade

- [Upgrade on Docker | OpenMetadata Deployment Upgrade Guide](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/docker.md): Perform upgrades for Docker-based deployments by managing image versions, environment variables, and service configurations.
- [Docker Upgrade Troubleshooting](https://docs.open-metadata.org/v2.1.x-SNAPSHOT/deployment/upgrade/docker-troubleshooting.md): Resolve common permission and configuration issues encountered when upgrading OpenMetadata on Docker deployments.
