CloudNexus Documentation

Comprehensive guides, API references, and configuration examples for building, deploying, and scaling cloud infrastructure.

Overview

CloudNexus provides an integrated suite of cloud infrastructure services designed for high availability, automated scaling, and developer-first tooling. The platform supports multi-region deployments, Kubernetes orchestration, managed databases, and a global edge network spanning 50+ data centers.

ℹ️

New in v3.2

AI-driven auto-scaling, enhanced multi-region failover, and native Terraform provider updates. See the changelog for full details.

Quick Start

Get your first environment running in under 3 minutes. Install the CLI, authenticate with your account, and deploy a sample workload.

1. Install the CLI

bash

# macOS / Linux
curl -fsSL https://cli.cloudnexus.io/install.sh | sh

# Windows (PowerShell)
iex (irm https://cli.cloudnexus.io/install.ps1)

2. Authenticate

bash

cnx auth login
# Open browser to complete OAuth flow
# Or use API key directly:
cnx auth login --token $CNX_API_KEY

3. Deploy Sample App

bash

cnx init my-project
cd my-project
cnx deploy --region us-east-1 --env production

✅

Deployment Successful

Once deployed, your endpoint will be available at my-project.cloudnexus.app with automatic TLS provisioning.

API Reference

All CloudNexus resources can be provisioned and managed via our RESTful API. Base endpoint: https://api.cloudnexus.io/v3

Create Compute Instance

http

POST /compute/instances
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "name": "prod-api-01",
  "plan": "cnx-c2-4x16",
  "region": "us-east-1",
  "image": "ubuntu-22.04-lts",
  "ssh_keys": ["ssh-rsa AAAAB3NzaC..."],
  "network": "default",
  "auto_backup": true
}

Parameter	Type	Required	Description
`name`	string	Yes	Unique identifier for the instance
`plan`	string	Yes	SKU tier (e.g., `cnx-c2-4x16` = 4 vCPU, 16GB RAM)
`region`	string	Yes	Deployment region slug
`auto_backup`	boolean	No	Enable daily snapshot scheduling (default: false)

Configuration

CloudNexus supports configuration via YAML manifests, environment variables, or the control panel. Manifests are recommended for reproducible deployments.

yaml

# cnx.yaml
apiVersion: cloudnexus.io/v3
kind: Application
metadata:
  name: ecommerce-platform
  region: eu-west-1
spec:
  compute:
    replicas: 3
    plan: cnx-c2-8x32
    autoScale:
      enabled: true
      minReplicas: 2
      maxReplicas: 12
      cpuThreshold: 75
  database:
    engine: postgresql
    version: "15"
    tier: standard-m
    backups: daily
  cdn:
    enabled: true
    cacheRules:
      - path: /static/**
        ttl: 3600
      - path: /api/**
        ttl: 0

⚠️

Region Restrictions

Multi-region deployments require the Enterprise tier. Cross-region data replication may incur additional bandwidth costs.

Troubleshooting

Common CLI Errors

ERR_AUTH_TOKEN_EXPIRED → Run cnx auth refresh
ERR_REGION_UNAVAILABLE → Check status page for regional outages
ERR_QUOTA_EXCEEDED → Contact sales to increase instance limits

bash

# Debug deployment failures
cnx logs instance/prod-api-01 --tail 50

# Validate configuration before applying
cnx validate cnx.yaml

# Dry-run deployment
cnx deploy --dry-run