Skip to content

Aftora/Cascade-CLI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

Cascade CLI

Official command-line interface for Cascade, enabling node deployment, infrastructure onboarding, and deterministic migration of existing hosting environments into the Aftora infrastructure stack.


Overview

Cascade CLI is the infrastructure deployment and migration tool for the Cascade platform.

It allows operators to provision new nodes, standardise infrastructure, and migrate existing environments — including Pterodactyl, WHMCS-based hosting stacks, and traditional VPS panels — into a unified, policy-enforced Cascade architecture.

Designed for production environments, Cascade CLI ensures that all deployed nodes conform to Headwaters-defined security invariants and Fabric-enforced policy controls.


Core Capabilities

  • Node provisioning and bootstrap automation
  • Secure node registration into Cascade
  • Infrastructure validation and hardening
  • Migration tooling for:
    • Pterodactyl environments
    • WHMCS-based hosting stacks
    • VPS control panels
  • Reverse proxy and routing configuration
  • SSL automation
  • Configuration normalization and drift detection

Migration Philosophy

Cascade CLI focuses on deterministic transformation rather than ad-hoc imports.

When migrating environments, it:

  • Audits existing configurations
  • Identifies incompatibilities
  • Applies secure normalization
  • Enforces policy compliance
  • Produces reproducible infrastructure state

The goal is not just “move it over,” but to elevate it into a hardened Cascade-native architecture.


Security Model

  • All node registrations are authenticated and validated
  • Migration workflows enforce security invariants
  • Policy enforcement delegated to Fabric where applicable
  • Explicit confirmation required for destructive operations
  • Fail-closed defaults
  • No implicit privilege escalation

Design Principles

  • Deterministic infrastructure onboarding
  • Secure-by-default node configuration
  • Idempotent migrations
  • Explicit operator control
  • Reproducible state transitions

Installation

macOS / Linux

curl -fsSL https://cascade.onl/install.sh | sh

Example Usage

cascade node bootstrap
cascade node register
cascade migrate pterodactyl
cascade migrate whmcs
cascade migrate vps-panel
cascade node inspect

Ecosystem Integration

Cascade CLI operates within the Aftora ecosystem:

  • Headwaters — foundational security and interoperability specification
  • Fabric — licensing and signed-action control plane
  • Aftora CLI — platform-wide orchestration
  • ui.aftora.systems — official design system

License

MIT

About

Official command-line interface for Cascade, enabling secure node deployment, infrastructure standardisation, and deterministic migration of legacy hosting environments into the Aftora ecosystem.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors