Docs / Guides / Quick Start

🚀 Deploy Your First Infrastructure in 5 Minutes

Follow this step-by-step guide to install the CloudNexus CLI, authenticate your environment, and provision a production-ready server with auto-scaling and monitoring enabled.

CLI Deployment ~5 min v2.4.0+
Completion Progress 0 / 5 Steps
1

Install the CloudNexus CLI

Get the command-line tool for your operating system

The CloudNexus CLI provides a fast, secure interface to manage your cloud resources. Choose your platform:

macOS / Linux 
curl -fsSL https://cli.cloudnexus.dev/install.sh | sh
# Verify installation
nx --version
Windows (PowerShell) 
winget install CloudNexus.CLI
# Or via npm
npm install -g @cloudnexus/cli
nx --version
💡 Prerequisite: Ensure you have Node.js 18+ or Go 1.20+ installed if building from source. The installer handles dependencies automatically.
2

Authenticate & Configure API Key

Securely link your CLI to your CloudNexus account

Generate an API key from your dashboard or use OAuth SSO for team environments:

Terminal 
# Interactive login (recommended)
nx auth login

# Or use environment variable
export CLOUDNEXUS_TOKEN="nx_live_8x9k2m..."
nx auth verify

This creates a local config at ~/.cloudnexus/config.yaml and enables auto-refreshing tokens.

🔐 Security: Never commit tokens to version control. Use workspace-scoped keys for CI/CD pipelines.
3

Create & Initialize Project

Define your infrastructure stack and networking

Scaffold a production-ready project with default networking, monitoring, and security policies:

Terminal 
nx project init my-app
# Output: Created ./my-app with nx.yaml

# Initialize with template
nx init --template k8s-nginx --region us-east-1 --tier standard
cd my-app

Open nx.yaml to adjust compute specs, storage classes, or enable managed databases:

nx.yaml 
compute:
  replicas: 2
  autoscale: true
  limits:
    cpu: "4"
    memory: "8Gi"

networking:
  cdn: enabled
  firewall: strict
4

Deploy Your Infrastructure

Provision resources with zero-downtime rollout

Apply your configuration. CloudNexus handles container orchestration, load balancing, and SSL provisioning automatically:

Terminal 
nx deploy --env production --auto-scale
# Watching logs...
# ✓ Cluster provisioned (us-east-1)
# ✓ Ingress configured → my-app.cloudnexus.app
# ✓ SSL certificate issued
# ✓ Health checks passing

Monitor the rollout in real-time:

Terminal 
nx logs --follow
nx status --watch
5

Verify & Connect

Validate your deployment and access your services

Run the built-in health validator to ensure all components are operational:

Terminal 
nx verify --full
# ├─ Network: OK (12ms latency)
# ├─ Storage: OK (NVMe mounted)
# ├─ Database: OK (PostgreSQL 15.4)
# └─ Firewall: OK (Strict policy active)
✅ Deployment Successful
  • • Your app is live at https://my-app.cloudnexus.app
  • • SSH access: nx ssh --node primary
  • • Dashboard: Open in Browser →
  • • Next steps: Configure CI/CD, add databases, or scale globally