Self-Hosted Deployment

Deploy Align on your own infrastructure for complete data sovereignty.

Why Self-Host?

• Data Sovereignty — All data stays in your infrastructure
• Air-Gapped Environments — Works without internet access
• Custom LLMs — Use your own models (Ollama, vLLM, etc.)
• Compliance — Meet regulatory requirements
• Integration — Deep integration with internal systems

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                     Your Kubernetes Cluster                      │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────────────┐ │
│  │    UI    │  │ Gateway  │  │  Brain   │  │   Connectors     │ │
│  │ SvelteKit│  │ Fastify  │  │ FastAPI  │  │ Slack/Teams/...  │ │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────────┬─────────┘ │
│       │             │             │                  │           │
│       └─────────────┴─────────────┴──────────────────┘           │
│                            │                                     │
│                    ┌───────┴───────┐                            │
│                    │  PostgreSQL   │                            │
│                    │   (RDS/Self)  │                            │
│                    └───────────────┘                            │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Components

Component	Purpose	Port
UI	SvelteKit frontend	3000
Gateway	API server (Fastify)	8080
Brain	AI/ML service (FastAPI)	8090
Connectors	Integration services	808x
PostgreSQL	Database	5432

Prerequisites

• Kubernetes 1.25+
• Helm 3.10+
• PostgreSQL 15+ (self-managed or managed like RDS)
• 4GB+ RAM available for Align pods
• (Optional) GPU for local LLM inference

Quick Start

# Add the Align Helm repository
helm repo add align https://charts.align.tech
helm repo update

# Install with default values
helm install align align/align \
  --namespace align \
  --create-namespace \
  --set database.secretName=your-db-secret

# Check status
kubectl get pods -n align

See Installation for detailed instructions.

Deployment Options

Minimal (Development/POC)

• Single replica per service
• Local PostgreSQL
• No HA, minimal resources

helm install align align/align -f values-minimal.yaml

Production

• Multiple replicas with HPA
• External PostgreSQL (RDS)
• TLS, proper ingress
• Secrets management

helm install align align/align -f values-production.yaml

What's Included

The Helm chart deploys:

• All Align services (UI, Gateway, Brain)
• Connectors (Slack, Teams, Jira, GitHub)
• Database migrations (as pre-install hook)
• Ingress configuration
• HPA and PDB for availability
• Service accounts and RBAC

What You Provide

• Kubernetes cluster
• PostgreSQL database
• Secrets (OAuth credentials, API keys)
• Ingress controller (Traefik, nginx, etc.)
• TLS certificates (cert-manager recommended)
• (Optional) Custom LLM server

Documentation

Guide	Description
Installation	Step-by-step install guide
Configuration	Helm values reference
Secrets	Secrets management options
OAuth Apps	Register your own OAuth apps
LLM Setup	Configure custom LLM providers
Upgrades	Upgrade and migration guide

Support

For self-hosted support:

• GitHub Issues: aligndottech/align-stack
• Email: support@align.tech