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.
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
- 🚀 Quick Demo: Visit anomstack-demo.fly.dev to see Anomstack in action
- 📖 Follow Guides: Choose your deployment method from the guides below
- ⚙️ Configure Metrics: Set up your first metric batch
- 🔔 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! 🎉