Multitoolbox Reference

Multitoolbox — Complete Reference

The Multitoolbox is the primary command-line utility for managing legacy FluxNodes. It provides a menu-driven interface for installation, configuration, diagnostics, and maintenance. To launch it, SSH into your node and run:

bash -i <(curl -s https://raw.githubusercontent.com/RunOnFlux/fluxnode-multitool/master/multitoolbox.sh)

Option 1 — Install Docker

Installs the Docker runtime required by FluxOS to manage application containers. This is typically the first step when setting up a fresh server. It installs Docker CE, configures the Docker daemon, and enables the Docker service.

Option 2 — Install FluxNode

Full FluxNode installation. Installs the Flux daemon (fluxd), FluxOS, FluxBench, and all dependencies. Walks you through entering your collateral transaction details, Flux private key, and node configuration. This is the main installation option for new legacy nodes.

Option 3 — Analyzer & Fixer

The most commonly used diagnostic tool. It analyzes your node's health by checking:

• •Daemon synchronization status and block height
• •FluxOS connectivity and API availability
• •Benchmark status and results
• •Docker service health
• •Network connectivity (ports, firewall)
• •Disk space and resource usage
• •Node status on the Flux network (confirmed, DOS list, start list)

The Analyzer also attempts automatic fixes for common issues. After running, it generates a report you can share in the Flux Discord for community support.

Option 4 — Install Watchdog

Installs the Watchdog auto-update daemon. Watchdog continuously monitors your node and automatically updates FluxOS, the Flux daemon, and FluxBench when new versions are released. It also monitors for stuck processes and can restart services automatically. Supports Discord and Telegram webhook notifications.

Option 5 — Restore Flux Blockchain

Downloads and restores the blockchain from a bootstrap snapshot. Use this when your daemon is stuck syncing, corrupted, or when you want to speed up initial sync on a new node. It downloads the latest verified blockchain snapshot and replaces the local copy.

Option 6 — Create Install Config File

Generates a configuration file with your node's identity details (private key, collateral TX, output index). This is useful for re-installation or migration — you can feed the config file to Option 2 to skip manual input.

Option 7 — Re-Install FluxOS

Performs a clean reinstallation of FluxOS without touching the daemon or blockchain data. Use this when FluxOS is behaving erratically, npm dependencies are broken, or after a failed update. It removes the existing FluxOS installation and pulls a fresh copy from GitHub.

Option 8 — Daemon Configuration

Fixes common daemon configuration issues: incorrect Identity Key, wrong Transaction ID, mismatched Output Index. This option edits the flux.conf file and restarts the daemon with the corrected values.

Option 11 — Reconfigure FluxOS

Changes FluxOS settings without a full reinstall. Use this to update your API port, Kadena address, router IP, or other FluxOS-specific configuration options.

Option 13 — MongoDB Repair

Repairs and re-indexes the MongoDB databases used by FluxOS. MongoDB stores local app data, blockchain explorer indexes, and app specifications. If your node shows database errors or apps aren't loading correctly, this option can fix corruption.

Option 14 — Enable Multi-Node (UPnP)

Configures UPnP port forwarding for running multiple nodes behind a single router. Each node needs unique ports, and this option sets up the necessary port mappings. Requires a UPnP-capable router.