Install CloudNexus Agent

📋 Prerequisites

Ensure your environment meets the minimum requirements before proceeding.

🚀 Installation

Select your operating system or deployment method below.

# Add CloudNexus repository
curl -fsSL https://repo.cloudnexus.io/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/cloudnexus.gpg
echo "deb [signed-by=/usr/share/keyrings/cloudnexus.gpg] https://repo.cloudnexus.io/apt stable main" | sudo tee /etc/apt/sources.list.d/cloudnexus.list

# Install the agent
sudo apt update
sudo apt install -y cloudnexus-agent

sudo rpm --import https://repo.cloudnexus.io/gpg.key
sudo tee /etc/yum.repos.d/cloudnexus.repo <<-'EOF'
[cloudnexus]
name=CloudNexus Official Repository
baseurl=https://repo.cloudnexus.io/yum
enabled=1
gpgcheck=1
gpgkey=https://repo.cloudnexus.io/gpg.key
EOF

sudo dnf install -y cloudnexus-agent

brew tap cloudnexus/tap
brew install cloudnexus-agent

curl -L https://dl.cloudnexus.io/cli/latest/cloudnexus-darwin-arm64.tar.gz -o cnx.tar.gz
tar -xzf cnx.tar.gz
sudo mv cloudnexus-agent /usr/local/bin/
sudo chmod +x /usr/local/bin/cloudnexus-agent

# Winget
winget install CloudNexus.Agent

# Scoop
scoop bucket add cloudnexus https://github.com/cloudnexus/scoop-bucket.git
scoop install cloudnexus-agent

# Download and run
https://dl.cloudnexus.io/cli/latest/cloudnexus-agent-x64.msi

docker run -d \
  --name cloudnexus-agent \
  --restart unless-stopped \
  -e CNX_API_KEY="$CNX_API_KEY" \
  -e CNX_CLUSTER_ID="$CNX_CLUSTER_ID" \
  -v /var/run/docker.sock:/var/run/docker.sock \
  cloudnexus/agent:latest

helm repo add cloudnexus https://charts.cloudnexus.io
helm repo update

helm install cnx-agent cloudnexus/cloudnexus-agent \
  --namespace cloudnexus-system --create-namespace \
  --set apiKey="$CNX_API_KEY" \
  --set clusterId="$CNX_CLUSTER_ID"

✅ Verify Installation

Run the following command to confirm the agent is running and connected:

If you see Connected & Syncing..., your installation is successful.

⚡ Quick Start

1. 1
   Authenticate

   Log in with your account token:

   Copy

   cnx auth login --token $CNX_API_KEY

2. 2
   Initialize Project

   Scaffold a new deployment configuration:

   Copy

   cnx init my-app --template node-express

3. 3
   Deploy

   Push your infrastructure to CloudNexus:

   Copy

   cd my-app && cnx deploy --region us-east-1

🔧 Troubleshooting