ArcaneOS Installation Guide
Step-by-step guide to installing ArcaneOS — the hardened OS for PNR-eligible Flux nodes.
ArcaneOS Installation Guide
ArcaneOS is a hardened, Ubuntu 24-based operating system designed specifically for Flux nodes. Launched on March 31, 2025, it replaces the legacy manual Linux setup with a streamlined, security-first approach. ArcaneOS introduces the SAS (Secure Autonomous System) security protocol, automatic self-healing, and — critically — eligibility for Progressive Node Rewards (PNR).
ArcaneOS is required for PNR eligibility. Legacy nodes cannot earn progressive rewards regardless of uptime or configuration.
Prerequisites
- •Architecture: AMD64 only (ARM/Apple Silicon not supported)
- •Installation type: Bare metal or virtual machine (VM)
- •TPM 2.0: Required for UEFI Secure Boot — ensure your BIOS/hypervisor supports it
- •Network: Stable internet connection with a static or forwarded IP address
- •Collateral: Flux collateral ready in ZelCore or SSP Wallet (1,000 / 12,500 / 40,000 FLUX)
Step 1 — Create a Virtual Machine (if applicable)
If running on a hypervisor (Proxmox, VMware, Hyper-V), create a new VM with the following settings:
| Setting | Cumulus | Nimbus | Stratus |
|---|---|---|---|
| CPU cores | 4+ | 8+ | 16+ |
| RAM | 8 GB+ | 32 GB+ | 64 GB+ |
| Storage (SSD) | 240 GB+ | 480 GB+ | 960 GB+ |
| Boot mode | UEFI | UEFI | UEFI |
| TPM | 2.0 | 2.0 | 2.0 |
Always allocate slightly more than the minimum. ArcaneOS and FluxOS consume system resources on top of what is available for apps. A Cumulus node needs at least 7 GB RAM total (5 GB for apps + 2 GB reserved).
Step 2 — Download & Boot the ISO
- 1
Download ArcaneOS ISO
Get the latest ISO from the official Flux download page or through your ZelCore wallet under the ArcaneOS section.
- 2
Create bootable media
For bare metal: flash the ISO to a USB drive using Balena Etcher or Rufus. For VMs: mount the ISO directly.
- 3
Boot from ISO
Set your BIOS/VM to boot from the ISO. The ArcaneOS installer will launch automatically.
Step 3 — OS Installation
The installer is guided and largely automated. It will partition the disk, install the base Ubuntu 24 system, and apply the ArcaneOS security hardening layer. Follow the on-screen prompts to configure your timezone, keyboard layout, and initial user account.
Step 4 — Platform Key Configuration
After the first boot, ArcaneOS will prompt you to configure your Platform Key. This cryptographic key ties your node to the Flux network and is essential for node identity verification.
Step 5 — FluxNode Configuration
Configure your FluxNode using one of three methods:
- 1
Manual configuration
Enter your collateral transaction hash, output index, and Flux private key manually. Best for advanced users.
- 2
ZelCore Token
Generate a configuration token from ZelCore wallet and paste it into the ArcaneOS setup. Simplest method for ZelCore users.
- 3
SSP Token
Generate a token from SSP Wallet. Works the same way as ZelCore but uses SSP's key management.
Step 6 — Notifications
ArcaneOS supports built-in notification channels. Configure Discord webhooks or Telegram bot tokens to receive alerts about node status changes, benchmark results, and maintenance events.
Step 7 — SSH Access
SSH is available for remote management. ArcaneOS enforces key-based authentication by default. During setup, you can add your public SSH key. Password-based SSH login is disabled for security.
After installation, ArcaneOS handles updates automatically. Unlike legacy nodes, you do not need to install Watchdog or manually run FluxOS updates — the system is fully self-maintaining.
Other articles in Advanced Operations
Legacy vs ArcaneOS
Feature comparison, migration path, and decision guide for choosing between Legacy and ArcaneOS.
Multitoolbox Reference
Complete reference for all 14 Multitoolbox options — installation, diagnostics, repair, and configuration.
Maintenance Window Deep Dive
Understanding the 480-block confirmation cycle, timing strategies, and monitoring your window status.
Troubleshooting & Diagnostics
Common node issues, log analysis, benchmark failures, DOS list recovery, and diagnostic techniques.
FluxOS API Reference
Essential API endpoints for monitoring, automation, and building tools on top of the Flux network.
Backup, Restore & Migration
Back up your node identity, restore from scratch, and migrate between hosts with zero collateral risk.
Multi-Node & Delegate Setup
Run multiple nodes with UPnP, Proxmox Fractus setups, and the P2SH delegate system.