Quick Start Guide

Deploy your first application on CloudNexus in under 5 minutes. This guide covers installation, authentication, and your first deployment.

Prerequisites

  • A free CloudNexus account with an active API key
  • Git installed and configured on your local machine
  • Basic familiarity with command-line interfaces
  • Node.js 18+ or Python 3.10+ (for example apps)
ℹī¸
API Key Required You can generate your API key in the CloudNexus Dashboard under Settings → Security → API Keys. Keep it secure; it grants full access to your account.

Step 1: Install the CLI

The CloudNexus Command Line Interface (cnx-cli) is the fastest way to manage resources, deploy applications, and monitor infrastructure.

Terminal (macOS / Linux)
curl -fsSL https://install.cloudnexus.io/cli | bash # Verifying installation... cnx --version
Terminal (Windows PowerShell)
iwr https://install.cloudnexus.io/cli.ps1 -useb | iex # Verify installationcnx --version

Step 2: Authenticate

Connect your local CLI to your CloudNexus account using your API key.

Terminal
cnx auth login --key YOUR_API_KEY # Alternatively, use interactive browser logincnx auth login
⚠ī¸
Security Notice Never hardcode your API key in source code or commit it to version control. Use environment variables or the CLI's secure credential store.

Step 3: Initialize & Configure

Create a new project directory and initialize a CloudNexus configuration file. This file defines your infrastructure, regions, and scaling rules.

Terminal
mkdir my-cloud-app && cd my-cloud-app cnx init --template node-express cnx config set region us-east-1

This generates a cloudnexus.yaml file. Here's a minimal example:

cloudnexus.yaml
project: my-cloud-app region: us-east-1 runtime: nodejs18.x scaling: min_instances: 2 max_instances: 10 cpu_threshold: 75% database: type: postgresql size: standard-medium cdn: true

Step 4: Deploy

Push your application to CloudNexus with a single command. The platform automatically builds, provisions infrastructure, and routes traffic.

Terminal
cnx deploy --env production # Watching deployment logs... # ✅ Build successful # 🌐 Infrastructure provisioned # 🚀 Live: https://my-cloud-app.cloudnexus.app
✅
Deployment Complete Your application is now live. CloudNexus automatically assigned a custom subdomain, provisioned SSL certificates, and configured load balancing.

Verify & Monitor

Check the health of your deployment and view real-time metrics:

  • cnx status - View instance status, region, and uptime
  • cnx logs --follow - Stream application logs in real-time
  • cnx monitor - Open the web dashboard for CPU, memory, and network metrics
Terminal
cnx logs --follow --tail 50 # [INFO] Server listening on port 8080 # [INFO] Connected to database: primary-us-east # [INFO] Health check: OK (99.99% uptime)

Next Steps

You've successfully deployed your first application. Explore these resources to scale your infrastructure:

đŸ“Ļ Database Management

Learn how to provision, scale, and back up managed PostgreSQL and Redis instances.

Read Database Docs →

🔄 Auto-Scaling Policies

Configure intelligent scaling rules based on CPU, memory, or custom metrics.

Configure Scaling →

🌍 Global Edge Network

Optimize latency by routing users to the nearest edge location worldwide.

Enable Global CDN →

🔐 Security & IAM

Implement role-based access, firewall rules, and encryption at rest/in transit.

Secure Your App →
"}