Getting Started

Installation

Full production installation guide for Cascade and the Cascadia node daemon.

On this page

Installation

This page covers a full production installation of Cascade — including security hardening, firewall configuration, and high-availability considerations.

System requirements

Node servers (Cascadia)

ResourceMinimumNotes
CPU1 coreScales with workload count
RAM2 GBMore RAM = more workload capacity
Disk10 GB + workload storageSSD strongly recommended
Network100 Mbps1 Gbps for game server nodes

Panel

The Cascade panel is always provisioned and managed by Aftora — there is nothing to install on your end. Once your account is active, Aftora provides you with your panel URL and credentials.

Cascadia daemon installation

Quick install

curl -fsSL https://install.cascadia.aftora.io | bash

Manual install

If you prefer to inspect the installer before running it:

# Download and inspect
curl -fsSL https://install.cascadia.aftora.io -o install-cascadia.sh
less install-cascadia.sh

# Run when satisfied
bash install-cascadia.sh

What the installer does

  1. Detects your OS and installs system packages (curl, jq, util-linux)
  2. Downloads the latest cascadiad binary to /usr/local/bin/cascadiad
  3. Creates the system user cascadia
  4. Writes the systemd unit to /etc/systemd/system/cascadia.service
  5. Enables and starts the service
  6. Prints your node registration token

Verifying the installation

# Check daemon status
systemctl status cascadia

# View live logs
journalctl -u cascadia -f

# Check daemon version
cascadiad --version

Firewall configuration

Cascadia communicates outbound over HTTPS (port 443) to the Aftora edge network. No inbound ports need to be opened for the daemon itself.

Workload-specific ports (e.g. game server ports, web ports) are managed per-workload in the panel.

# Example: allow game server port range (adjust to your needs)
ufw allow 25565:25600/tcp  # Minecraft
ufw allow 25565:25600/udp

Updating Cascadia

# Pull the latest daemon binary
cascadiad update

# Or via the panel: Infrastructure → Nodes → [node] → Update Daemon

Uninstalling

# Stop and disable the service
systemctl stop cascadia
systemctl disable cascadia

# Remove files
rm /usr/local/bin/cascadiad
rm /etc/systemd/system/cascadia.service
systemctl daemon-reload