Deployment Overview

Helm Chart

Marquez uses Helm to manage deployments onto Kubernetes in a cloud environment. The chart and templates for the HTTP API server and Web UI are maintained in the Marquez repository and can be found in the chart directory. The chart’s base values.yaml file includes an option to easily override deployment settings.

Note: The Marquez HTTP API server and Web UI images are published to DockerHub.


To enable HTTPS traffic when deploying Marquez onto Kubernetes, use the flag ingress.enabled to configure the ingress controller. To secure ingress traffic, use the ingress.tls section to define your TLS secret and hosts (see ingress in the chart’s base values.yaml for more details).


The Marquez HTTP API server relies only on PostgreSQL to store dataset, job, and run metadata allowing for minimal operational overhead. We recommend a cloud provided databases, such as AWS RDS, when deploying Marquez onto Kubernetes.

Note: We encourage enabling encryption at rest when provisioning your database.



Figure 1: Minimal Marquez deployment via Docker.


Figure 2: Marquez deployment via Kubernetes.


Component Image Description
Marquez Web UI marquezproject/marquez-web The web UI used to view metadata.
Marquez HTTP API marquezproject/marquez The core API used to collect metadata using OpenLineage.
Database bitnami/postgresql or cloud provided A PostgreSQL instance used to store metadata.
Scheduler User-provided A scheduler used to run a workflow on a particular schedule (ex: Airflow)
Workflow User-provided A workflow using an OpenLineage integration to send lineage metadata to Marquez.


Our clients support authentication by automatically sending an API key on each request via Bearer Auth when configured on client instantiation.

Note: By default, the Marquez HTTP API server does not require any form of authentication or authorization.

Next Steps

The following guides will help you and your team effectively deploy and manage Marquez in a cloud environment:

SPDX-License-Identifier: Apache-2.0 Copyright 2018-2023 contributors to the Marquez project.