Atlan architecture
Understand Atlan's current platform architecture: deployment model, component groups, AI infrastructure, Metadata Lakehouse, and the self-deployed runtime.
Atlan is a cloud-first, single-tenant SaaS platform. Each tenant has its own dedicated compute and storage, isolated from other tenants within Kubernetes. Atlan currently supports AWS, Azure, and GCP as hosting platforms.
Architecture diagrams
The component groups are the same on every cloud. Only the underlying cloud services differ:
| Service | AWS | Azure | GCP |
|---|---|---|---|
| Managed Kubernetes | Amazon EKS | Azure Kubernetes Service (AKS) | Google Kubernetes Engine (GKE) |
| Object storage | Amazon S3 | Azure Blob Storage | Google Cloud Storage |
Amazon Web Services (AWS)
Microsoft Azure
Google Cloud Platform (GCP)
Architecture layers
The platform is organized into three deployment layers: customer infrastructure, the Atlan tenant (per cloud region), and Atlan's shared control planes.
Customer infrastructure
Hosted in the customer's cloud account or on-premises network, never inside Atlan's infrastructure.
| Component | Role |
|---|---|
| Data sources | The customer's databases, warehouses, BI tools, and source systems that Atlan connects to |
| Self-Deployed Runtime (SDR) | Customer-hosted Temporal Worker, Dapr sidecar, and application code used for connectors that require network access to on-premises or VPC-locked sources. The worker communicates back to Atlan's Temporal server over a persistent gRPC connection. |
Atlan tenant
Each tenant runs in an isolated Kubernetes environment within the selected cloud provider, with its own dedicated compute and storage. For how tenants are isolated from each other, see How are resources isolated?
The component groups below are identical on every cloud. For the managed Kubernetes and object storage services on each cloud, see Architecture diagrams.
API & Identity
| Component | Role |
|---|---|
| Kong | API gateway: rate limiting, JWT validation, token routing |
| Heracles | Core platform API service: assets, lineage, search, governance business logic |
| Keycloak | Identity and access management: SSO, OIDC/SAML, user and group sync |
| Heka | SQL gateway: parses and rewrites SQL queries using Apache Calcite |
Metastore
| Component | Role |
|---|---|
| Apache Atlas | Metadata store: assets, relationships, and classifications. Metadata is persisted in Cassandra and indexed in Elasticsearch |
| Apache Cassandra | Persistence backend for Atlas |
| Elasticsearch | Full-text search and filtering across metadata |
Orchestration
| Component | Role |
|---|---|
| Temporal | Primary workflow orchestration engine: connectors, lineage pipelines, and long-running platform jobs |
| Argo Workflows | Legacy orchestration path. Some remaining workflows still run on Argo while they're migrated to Temporal. Planned decommission once that migration completes |
| Admission Controller | Kubernetes admission webhook: validates and mutates Kubernetes resource admission. Still in use; planned deprecation alongside Argo Workflows |
Atlan AI
| Component | Role |
|---|---|
| AI Gateway | Centralized LLM proxy: multi-provider routing, rate limiting, per-tenant budget controls, cost tracking, and observability. Deployed across the United States, EU, and APAC regions. |
| TurboPuffer | Serverless vector and full-text search store: powers semantic search and conversational AI memory. Each tenant has dedicated namespaces, segmented by application and use case, each encrypted with a Customer Managed Encryption Key (CMEK). For the full isolation and encryption model, see Atlan AI security |
| Cloudflare Workers AI | Embedding generation for semantic search and retrieval. Only metadata and user-directory records (for example, names and usernames) are embedded. Atlan doesn't embed the data held in your source systems |
Metadata Lakehouse
| Component | Role |
|---|---|
| Apache Iceberg | Open table format for the Metadata Lakehouse |
| Polaris Catalog | REST-based Iceberg catalog for table management |
Data is stored in the tenant's dedicated S3 bucket (or equivalent object store on Azure/GCP).
Data & messaging
| Component | Role |
|---|---|
| Apache Kafka | Event stream: async event bus for platform-wide events |
| Redis | Cache layer used by platform services, including Heracles and Heka |
| PostgreSQL | Relational database for user, configuration, and service data |
| HashiCorp Vault | Secret management: stores the credentials you provide for connections |
Atlan control plane
Atlan-managed, multi-tenant infrastructure used to operate and monitor all customer clusters.
Platform operations
| Component | Role |
|---|---|
| Argo CD | GitOps continuous deployment: deploys Helm releases to tenant clusters |
| GitHub Actions | CI: builds and publishes container images |
| Grafana | Observability dashboards |
Application delivery
| Component | Role |
|---|---|
| Vue.js | Framework behind the Atlan web application, a single-page app |
| Amazon CloudFront | CDN that serves the web application |
Shared services
| Component | Role |
|---|---|
| SendGrid | Transactional email delivery |
Atlan AI control plane
Multi-region deployment (United States, EU, APAC) hosting the LLM providers accessible via the tenant-side AI Gateway. Traffic between tenant environments and the AI gateway uses VPC peering or PrivateLink to keep data within private network boundaries. For the full network, encryption, and data-handling model, see Atlan AI security.
For the providers and models currently in use, see Atlan AI security: model management.
Packages
Distinct packages, often for connectors, lineage processors, and other long-running jobs, run on the platform's orchestration layer and are installed independently on each instance on demand.
For security policies, audit reports, and certifications, see security.atlan.com. For details on resource isolation, see How are resources isolated?