Installation
This page covers a full production installation of Cascade — including security hardening, firewall configuration, and high-availability considerations.
System requirements
Node servers (Cascadia)
| Resource | Minimum | Notes |
|---|---|---|
| CPU | 1 core | Scales with workload count |
| RAM | 2 GB | More RAM = more workload capacity |
| Disk | 10 GB + workload storage | SSD strongly recommended |
| Network | 100 Mbps | 1 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
- Detects your OS and installs system packages (
curl,jq,util-linux) - Downloads the latest
cascadiadbinary to/usr/local/bin/cascadiad - Creates the system user
cascadia - Writes the systemd unit to
/etc/systemd/system/cascadia.service - Enables and starts the service
- 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