Deployment Guide
Self-hosted, cloud-hosted, and hybrid deployment options.
Deployment Modes
Cortyxia supports multiple deployment architectures to accommodate different infrastructure requirements, data sovereignty needs, and operational preferences. Each mode maintains the same core functionality while offering varying levels of control and management overhead.
Cloud-Hosted
Fully managed service where Cortyxia hosts all infrastructure and code. Your data resides in our cloud with automatic scaling, 99.9% uptime SLA, and zero maintenance overhead.
Self-Hosted Data
Host your data on your own infrastructure while Cortyxia code runs on our cloud. Connect your PostgreSQL and Redis instances for data sovereignty and compliance requirements.
Hybrid
Mix cloud-hosted and self-hosted data configurations. Keep sensitive data on-premises while using cloud infrastructure for less sensitive workloads.
Data Infrastructure Setup
For self-hosted data deployments, configure your PostgreSQL and Redis instances. Cortyxia will connect to these infrastructure components while the application logic runs on our cloud.
PostgreSQL Configuration
# Example PostgreSQL setup CREATE DATABASE cortyxia; CREATE USER cortyxia_user WITH PASSWORD 'secure_password'; GRANT ALL PRIVILEGES ON DATABASE cortyxia TO cortyxia_user; # Connection string format postgresql://cortyxia_user:secure_password@your-host:5432/cortyxia
Redis Configuration
# Example Redis setup redis-server --port 6379 --requirepass your_redis_password # Connection string format redis://:your_redis_password@your-host:6379
Network Configuration
Ensure your infrastructure allows inbound connections from Cortyxia cloud IPs. Configure firewall rules and VPC peering as needed.
# Allow PostgreSQL access firewall-cmd --add-port=5432/tcp --permanent # Allow Redis access firewall-cmd --add-port=6379/tcp --permanent # Reload firewall firewall-cmd --reload
Production Configuration
Database
PostgreSQL recommended for production deployments. SQLite for smaller setups.
ISO_PROJECT_DB_URL=postgresql://user:pass@host:5432/isoCaching Layer
Redis for production caching and session management.
REDIS_URL=redis://user:pass@host:6379SSL/TLS
Configure reverse proxy (nginx, traefik) with SSL certificates for HTTPS.
Security Hardening
Secrets Management
Use secret management systems (HashiCorp Vault, AWS Secrets Manager, Azure Key Vault) for sensitive configuration. Kubernetes Secrets for containerized deployments.
Network Security
Deploy in private subnets with bastion host access. Configure firewall rules for necessary ports only. Enable VPC peering for service communication.
Monitoring
Health check endpoints at /health. Prometheus metrics export at /metrics. Set up alerts for high error rates, latency, and service downtime.
Scaling Strategy
Horizontal Scaling
Increase replicas in Kubernetes or use Docker Compose scaling. Load balancer distributes traffic across instances.
Database Sharding
For large-scale deployments, shard by project namespace. Use PostgreSQL partitioning and read replicas for query optimization.
Performance Characteristics
Backup and Recovery
PostgreSQL Backup
# Backup pg_dump $ISO_PROJECT_DB_URL > backup.sql # Restore psql $ISO_PROJECT_DB_URL < backup.sql
SQLite Backup
# Backup cp iso.db iso.db.backup # Restore cp iso.db.backup iso.db