Fluxme.io
Advanced Operations

ArcaneOS Installation Guide

Step-by-step guide to installing ArcaneOS — the hardened OS for PNR-eligible Flux nodes.

12 min read
arcaneosinstallationpnrsetup

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:

SettingCumulusNimbusStratus
CPU cores4+8+16+
RAM8 GB+32 GB+64 GB+
Storage (SSD)240 GB+480 GB+960 GB+
Boot modeUEFIUEFIUEFI
TPM2.02.02.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. 1

    Download ArcaneOS ISO

    Get the latest ISO from the official Flux download page or through your ZelCore wallet under the ArcaneOS section.

  2. 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. 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. 1

    Manual configuration

    Enter your collateral transaction hash, output index, and Flux private key manually. Best for advanced users.

  2. 2

    ZelCore Token

    Generate a configuration token from ZelCore wallet and paste it into the ArcaneOS setup. Simplest method for ZelCore users.

  3. 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.