Skip to main content
Deploy and manage AeonSage on your own servers for complete control over your data and infrastructure.

​
Why Self-Host?

​
Deployment Options

Docker

Quick setup with Docker or Docker Compose. Best for most deployments.

Bare Metal

Direct installation on Linux servers. Maximum control.

​
Requirements

​
Minimum Requirements

ResourceRequirement
CPU2 cores
RAM4 GB
Storage20 GB SSD
Network100 Mbps
OSUbuntu 20.04+, Debian 11+, or RHEL 8+
ResourceRequirement
CPU4+ cores
RAM8+ GB
Storage100 GB SSD
Network1 Gbps
DatabasePostgreSQL 15+
If running local AI models (Ollama):
  • Add 8+ GB RAM per model
  • GPU recommended for better performance
  • Consider dedicated GPU instances

​
Architecture Options

​
Single Server

Simplest deployment for small teams or personal use. 
┌─────────────────────────────────────────┐
│            Single Server                │
├─────────────────────────────────────────┤
│                                         │
│  ┌──────────────────────────────────┐   │
│  │        AeonSage Gateway          │   │
│  │   (HTTP + WebSocket + Storage)   │   │
│  └──────────────────────────────────┘   │
│                                         │
│  ┌──────────────────────────────────┐   │
│  │      SQLite + sqlite-vec         │   │
│  └──────────────────────────────────┘   │
│                                         │
└─────────────────────────────────────────┘

​
High Availability

For production workloads requiring uptime guarantees. 
                      ┌─────────────┐
                      │Load Balancer│
                      └──────┬──────┘
                             │
          ┌──────────────────┼──────────────────┐
          │                  │                  │
          ▼                  ▼                  ▼
    ┌───────────┐      ┌───────────┐      ┌───────────┐
    │ Gateway 1 │      │ Gateway 2 │      │ Gateway 3 │
    └─────┬─────┘      └─────┬─────┘      └─────┬─────┘
          │                  │                  │
          └──────────────────┼──────────────────┘
                             │
                      ┌──────▼──────┐
                      │ PostgreSQL  │
                      │   Primary   │
                      └──────┬──────┘
                             │
                    ┌────────┴────────┐
                    │                 │
             ┌──────▼──────┐   ┌──────▼──────┐
             │  Replica 1  │   │  Replica 2  │
             └─────────────┘   └─────────────┘

​
Security Considerations

​
Cost Estimation

​
Cloud Provider Costs (Monthly)

ProviderInstance TypeCost (USD)
AWSt3.medium~$30
GCPe2-standard-2~$25
AzureStandard_D2s_v3~$35
DigitalOcean4GB Droplet~$24
HetznerCX21~$5
  • Use spot/preemptible instances for non-critical workloads
  • Consider reserved instances for long-term deployments
  • Monitor and right-size based on actual usage

​
Next Steps

After deploying and configuring AeonSage, consider setting up monitoring and observability to track system health, performance metrics, and usage patterns in your production environment.