CloudNexus Documentation

Welcome to the official CloudNexus documentation. This guide covers infrastructure provisioning, CLI configuration, Kubernetes orchestration, API integration, and production deployment strategies.

💡 v2.4.1 Release Note

AI-powered auto-scaling, multi-region active/active failover, and enhanced observability dashboards are now available. See the release notes for migration steps.

Platform Overview

CloudNexus provides a unified, developer-first infrastructure platform abstracting complexity while delivering enterprise-grade reliability. Built on bare-metal nodes with eBPF networking, our platform supports containerized workloads, managed databases, and global edge distribution.

Feature	Description	Availability
Compute Nodes	NVMe-backed VMs with dedicated vCPUs & burstable storage	50+ Regions
Kubernetes	Fully managed control plane with auto-scaling & service mesh	Global
Managed Databases	PostgreSQL, MySQL, Redis, MongoDB with point-in-time recovery	Enterprise
Global CDN	300+ edge locations, HTTP/3, real-time cache invalidation	All Plans

Quick Start

1. Install the CLI

Use your package manager to install the CloudNexus CLI tool:

npm install -g @cloudnexus/cli
# or via Homebrew
brew install cloudnexus/tap/cx

2. Authenticate

Generate an API key from your dashboard and configure the CLI:

cx auth login --token=cn_live_9f8e7d6c5b4a3210
# Verify installation
cx status

3. Deploy Your First Application

Create a cloudnexus.yaml configuration file in your project root:

name: my-app
region: us-east-1
runtime: nodejs-20
replicas: 2
scaling:
  min: 2
  max: 10
  trigger: cpu-75%
database:
  type: postgres
  version: 15
  backups: daily

Push and deploy to production:

cx deploy --prod

✅ Deployment Successful

Your application is now live at https://my-app.cloudnexus.app with automatic SSL provisioning and global CDN routing.

Authentication & API Keys

CloudNexus uses API keys for server-to-server authentication. Keys are scoped to specific projects, regions, and permission sets.

cn_live_cn_test_cn_svc_

Key Type	Prefix	Permissions
Production	Full access to live resources
Sandbox	Limited to staging/test environments
Service	Restricted to specific API endpoints

Always rotate keys every 90 days and use environment variables in production:

export CX_API_KEY="${CX_LIVE_KEY}"
cx deploy --env=production

Managed Kubernetes

CloudNexus runs fully managed Kubernetes clusters on bare-metal nodes with automatic control plane patching, eBPF networking, and built-in service mesh support.

Cluster Configuration

apiVersion: cloudnexus.io/v1
kind: Cluster
metadata:
  name: prod-k8s
spec:
  region: eu-west-2
  nodePools:
    - name: web-pool
      instanceType: c5.xlarge
      count: 3
      taints: ["dedicated=web:NoSchedule"]
    - name: worker-pool
      instanceType: m5.2xlarge
      count: 5
  addons:
    - prometheus
    - grafana
    - cert-manager
    - external-dns

⚠️ Production Considerations

Always enable multi-AZ deployments for production clusters. CloudNexus automatically distributes nodes across availability zones to ensure 99.999% uptime SLA compliance.

Common Issues & Solutions

Error	Cause	Resolution
`ERR_AUTH_FAILED`	Invalid or expired API key	Regenerate key via dashboard or CLI: `cx auth rotate`
`ERR_DEPLOY_TIMEOUT`	Health check failing during rollout	Check logs with `cx logs --follow` and verify container ports
`ERR_RATE_LIMITED`	Exceeded API quota (1000 req/min)	Implement exponential backoff or request quota increase
`ERR_DB_CONNECTION`	VPC peering or firewall misconfiguration	Verify security groups allow inbound on port 5432/3306

📞 Need Help?

Visit our community forum, check the status page, or contact support@cloudnexus.dev for priority assistance.