Docs › Getting Started › CLI Installation

CLI Installation

The CloudNexus Command Line Interface (cnctl) allows you to manage infrastructure, deploy applications, and monitor resources directly from your terminal. Installation takes less than a minute.

Prerequisites

macOS 10.15 (Catalina) or later, Ubuntu 20.04+/Debian 11+, or Windows 10/11
Homebrew (macOS), curl & sudo (Linux), or PowerShell 5.1+ (Windows)
Active CloudNexus account (sign up free at cloudnexus.dev)

Install on Your OS

If you have Homebrew installed, run the following command in your terminal:

bash

brew tap cloudnexus/cli
brew install cnctl

Verify the installation by checking the version:

bash

cnctl --version

Use our official installation script. It automatically handles dependencies and permissions:

bash

curl -fsSL https://install.cloudnexus.dev/linux | sudo sh -

Note for Ubuntu/Debian: The script will install cnctl to /usr/local/bin. Ensure your PATH includes this directory.

Use winget (recommended) or PowerShell to install the CLI:

powershell

winget install CloudNexus.CNCLI

If winget is unavailable, download the latest MSI from our releases page and run the installer with administrative privileges.

Verify Installation

Open a new terminal window and run the following command to confirm cnctl is properly installed and accessible:

bash

cnctl version
# Output: cnctl v2.4.1 (cloudnexus/official)

If you receive a command not found error, your terminal may need to be restarted to refresh the PATH environment variable.

Quick Start

Once installed, authenticate with your CloudNexus account and deploy your first project:

bash

# 1. Authenticate
 cnctl login

# 2. Initialize a new project
 cnctl init my-app
 cd my-app

# 3. Deploy to cloud
 cnctl deploy --region us-east-1

# 4. View live metrics
 cnctl monitor

For advanced configuration, run cnctl help or visit the CLI Reference.

Troubleshooting

Command not found after installation

This usually happens when your shell hasn't reloaded the PATH. Close and reopen your terminal, or run:

source ~/.bashrc or source ~/.zshrc

Permission denied when running cnctl

Ensure the binary has executable permissions. Run: chmod +x /usr/local/bin/cnctl (Linux/macOS). On Windows, run your terminal as Administrator during installation.

Proxy/Network errors during installation

If you're behind a corporate firewall, set the proxy environment variables before installing:
export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port