Deployment Overview

Anomstack offers flexible deployment options to fit different organizational needs and infrastructure requirements. This page helps you choose the right deployment pattern for your use case.

Architecture Simplification

🎉 Anomstack now uses gRPC-free architecture by default! This means simpler deployment, better reliability, and no separate code server needed. User code is loaded directly as Python modules within the Dagster webserver.

For advanced use cases requiring separate gRPC code servers, see our Architecture documentation for optional configuration.

Deployment Modes

🎯 Full Stack Deployment

Deploy the complete Anomstack platform including dashboard, backend services, and database infrastructure.

✅ Best for:

• New implementations
• Teams wanting the full Anomstack experience
• Organizations needing the dashboard interface
• Proof of concepts and demos

📦 Includes:

• Interactive dashboard for metrics visualization
• Dagster UI for pipeline management
• Complete alerting system (Email, Slack, LLM)
• Built-in storage for metrics and models

🤖 Headless Deployment

Deploy only the Dagster orchestration engine to integrate with your existing infrastructure.

✅ Best for:

• Organizations with existing analytics infrastructure
• Enterprise environments with strict data governance
• Teams preferring their current dashboards/alerting
• Microservices architectures

📦 Includes:

• Anomaly detection pipeline only
• Writes results to your existing database
• Configurable alert outputs (database, webhooks, etc.)
• Model storage in your preferred system

Deployment Platforms

Local Development

Perfect for development, testing, and small-scale deployments.

Method	Complexity	Best For
Docker Compose	🟢 Low	Quick start, local development
Python Virtual Env	🟡 Medium	Development, debugging

Cloud Platforms

Scalable options for production workloads.

Platform	Complexity	Scalability	Best For
Fly.io	🟢 Low	🟡 Medium	Global edge deployment
Google Cloud	🟡 Medium	🟢 High	GCP-native integration
Dagster Cloud	🟢 Low	🟢 High	Serverless, managed

Containerized Deployment

Option	Use Case
Docker Compose	Single-node deployment
Kubernetes	Multi-node, enterprise scale
Docker Swarm	Simple orchestration

Configuration Management

Feature	Description	Compatibility
Deployment Profiles	Environment-specific configurations (demo, production, dev)	Fly.io, Docker, Custom
Environment Variables	Runtime configuration overrides	All platforms
Hot Reload	Dynamic configuration updates	Docker, Local

Architecture Patterns

Pattern 1: All-in-One (Recommended for Getting Started)

# Everything in one deployment
make docker          # or
make fly-deploy      # or  
make dagster-cloud

Pros: Simple setup, everything included Cons: Single point of failure, harder to scale components independently

Pattern 2: Service Separation

Pros: Independent scaling, better reliability Cons: More complex setup and management

Pattern 3: Fully Distributed

Pros: Maximum scalability and reliability Cons: Most complex to set up and debug

Choosing Your Deployment

Quick Decision Tree

Configuration Examples

Full Stack Configuration

# .env for full stack
ANOMSTACK_DUCKDB_PATH=/data/anomstack.db
ANOMSTACK_DASHBOARD_HOST=0.0.0.0
ANOMSTACK_DASHBOARD_PORT=8080
ANOMSTACK_ALERT_EMAIL_FROM=alerts@company.com
ANOMSTACK_ALERT_EMAIL_TO=team@company.com
ANOMSTACK_SLACK_CHANNEL=#anomalies

Headless Configuration

# .env for headless deployment
ANOMSTACK_DB=bigquery
ANOMSTACK_TABLE_KEY=analytics.anomaly_detection.metrics
ANOMSTACK_MODEL_PATH=gs://company-ml-models/anomstack/
ANOMSTACK_DISABLE_DASHBOARD=true
ANOMSTACK_ALERT_WEBHOOK_URL=https://api.company.com/alerts

Next Steps

Getting Started

1. 🚀 Quick Demo: Visit anomstack-live-demo.fly.dev to see Anomstack in action
2. 📖 Follow Guides: Choose your deployment method from the guides below
3. ⚙️ Configure Metrics: Set up your first metric batch
4. 🔔 Test Alerts: Configure and test your alerting channels

Deployment Guides

• Docker Deployment - Self-hosted with Docker Compose
• Fly.io Deployment - Global edge deployment with managed infrastructure
• Deployment Profiles - Environment-specific configurations (demo, production, dev)
• Google Cloud Deployment - GCP-native integration
• Storage Optimization - Optimize storage for large deployments

Advanced Topics

• Environment Variables: Configuration Guide
• Metrics Setup: Metrics Configuration
• Hot Reloading: Dynamic Configuration

Support

• 💬 Community: GitHub Discussions
• 🐛 Issues: GitHub Issues
• 📚 Documentation: Browse the sections in the left sidebar
• 🎯 Examples: Metric Examples

Choose your deployment path and get started with reliable, open-source anomaly detection! 🎉