1 Account & Credentials

Ensure your CloudNexus account is properly configured with the necessary permissions and API access before provisioning resources.

Required Account Setup

Account Type Verified Enterprise or Pro
Auth Method MFA Enabled (Required)
Role Assignment Admin or Deployer scope
Billing Payment method verified
Important: API keys should be generated with the minimum required scopes. Avoid using root credentials for automated deployments.
# Generate scoped API key via CLI cnx auth key create --name deploy-key --scope compute,storage,network --expiry 30d

2 System & Infrastructure Requirements

Your local environment and target workloads must meet these specifications to interact reliably with the CloudNexus control plane.

Supported Operating Systems

Linux Ubuntu 20.04+, Debian 11+, RHEL 8+/Alma/Rocky
macOS 12 Monterey or newer (Apple Silicon & Intel)
Windows 10/11 Pro, Server 2019+ (WSL2 recommended)
Architecture x86_64, ARM64

For containerized workloads, ensure your host supports Kernel 5.10+ and has cgroups v2 enabled. Legacy init systems and outdated kernels may cause scheduling failures.

3 Network & Firewall Configuration

CloudNexus endpoints must be reachable from your management networks. Whitelist the following ranges if you operate behind corporate firewalls or proxies.

Required Ports & Endpoints

Control Plane api.cloudnexus.io:443
Object Storage *.storage.cnx.cloud:443
CDN & Anycast Registry registry.cloudnexus.io:443
# Verify connectivity curl --connect-timeout 5 --max-time 10 https://api.cloudnexus.io/v1/health # Expected: {"status":"operational","version":"2.4.1"}

4 CLI & Required Tools

Install and configure the official tooling to manage resources programmatically or via terminal.

Minimum Versions

CloudNexus CLI cnx v4.2.0+
Docker 24.0+
kubectl 1.28+ (matches cluster version ±1)
Terraform 1.5+ (provider cnx v3.1+)
# Install CLI (macOS/Linux) curl -fsSL https://install.cloudnexus.io | sh # Verify installation cnx --version # cnx version 4.3.1 (build 8a2f9c)

5 Compliance & Data Preparation

Review regulatory requirements and data handling policies before provisioning production workloads.

  • Ensure data residency matches your compliance framework (GDPR, HIPAA, SOC2, ISO 27001)
  • Configure encryption at rest (AES-256) and in transit (TLS 1.3)
  • Review IAM policies and apply least-privilege access for service accounts
  • Enable audit logging before initial deployment for compliance trails
Note: Workloads handling PII or financial data must be deployed in dedicated VPCs with private endpoints enabled. Public-facing instances require WAF rules configured at deployment.

6 Verification Checklist

Track your progress. Completed items are saved automatically to your browser.

CloudNexus account verified with MFA enabled
API key generated with appropriate scopes
Operating system meets minimum version requirements
Firewall allows outbound HTTPS to CloudNexus endpoints
CLI, Docker, and kubectl installed & verified
IAM roles and least-privilege policies configured
Data residency and encryption settings validated
Audit logging enabled for compliance tracking
Proceed to Deployment → Need Help? Contact Support