Releases: RunOnFlux/fluxd
v9.0.6
Flux v9.0.6 — Proof of Useful Work v2
Release Overview
The v9.0.6 release features a bug fix in undo state. Read more about the bug here #267.
Read more about v9.0.0 release here https://github.com/RunOnFlux/fluxd/releases/tag/v9.0.0
Whitepaper of PoUW v2
https://jetpack2_38080.app.runonflux.io/ipfs/QmW3TNPx5Ru3u3UhXf8GqyVNS3avSsttqjamhF395qe17M
How to Upgrade
Automatic Updates
If you're running a Flux node with automatic updates enabled, this release will be deployed automatically according to your update schedule.
Manual Installation
From Binary Releases:
- Download the appropriate binary for your platform from the GitHub releases page
- Stop your current Flux daemon:
flux-cli stop - Replace the old binaries with the new ones
- Restart your Flux daemon:
./fluxd -daemon
From Debian Package:
# Download and install the .deb package for your architecture
wget https://github.com/RunOnFlux/fluxd/releases/download/v9.0.6/flux-amd64-v9.0.6.deb
sudo dpkg -i flux-amd64-9.0.6.debBuilding from Source:
git clone https://github.com/RunOnFlux/fluxd.git
cd fluxd
git checkout v9.0.6
./zcutil/build.shUsing APT:
- Follow instructions on https://apt.runonflux.io
CDN, Bootstrap:
Full Changelog: v9.0.5...v9.0.6
v9.0.5
Flux v9.0.5 — Proof of Useful Work v2
Release Overview
The v9.0.5 release represents a stability update following the successful PON (Proof of Nodes) activation in v9.0.0. This version consolidates all improvements from v9.0.1 through v9.0.5, addressing chain reorganization issues, memory management, and network stability. Read more about v9.0.0 release here https://github.com/RunOnFlux/fluxd/releases/tag/v9.0.0
Key Technical Changes
Chain Stability Improvements: Enhanced chain reorganization handling with increased reorg limits, improved checkpoint system, and better undo data validation.
Memory Management: Fixes for memory leaks in the FluxNode cache system that previously caused out-of-memory (OOM) crashes in both daemon and RPC operations.
PON Minter Enhancements: Refined PON minting logic with improved target spacing, chainwork tiebreaker mechanisms, and better synchronization handling.
Block Processing: Introduction of out-of-order block support, allowing more flexible and resilient block validation under challenging network conditions.
Network Optimization: Improved peer management and connection handling with enhanced locking mechanisms for thread safety.
Upgrade Information
Recommended Upgrade: All nodes should update to v9.0.5 for optimal stability and to avoid potential memory issues and chain synchronization problems.
Post-PON Stabilization: These updates address real-world conditions encountered after the PON activation at block 2,020,000.
Installation Methods
The release provides multiple upgrade paths: automatic updates for nodes with that feature enabled, binary downloads, Debian packages, source compilation, and APT repository installation.
Expected Improvements
Users should anticipate more stable node operation, elimination of memory-related crashes, better handling of chain reorganizations, and improved network synchronization during edge-case scenarios.
Whitepaper of PoUW v2
https://jetpack2_38080.app.runonflux.io/ipfs/QmW3TNPx5Ru3u3UhXf8GqyVNS3avSsttqjamhF395qe17M
How to Upgrade
Automatic Updates
If you're running a Flux node with automatic updates enabled, this release will be deployed automatically according to your update schedule.
Manual Installation
From Binary Releases:
- Download the appropriate binary for your platform from the GitHub releases page
- Stop your current Flux daemon:
flux-cli stop - Replace the old binaries with the new ones
- Restart your Flux daemon:
./fluxd -daemon
From Debian Package:
# Download and install the .deb package for your architecture
wget https://github.com/RunOnFlux/fluxd/releases/download/v9.0.5/flux-amd64-v9.0.5.deb
sudo dpkg -i flux-amd64-9.0.5.debBuilding from Source:
git clone https://github.com/RunOnFlux/fluxd.git
cd fluxd
git checkout v9.0.5
./zcutil/build.shUsing APT:
- Follow instructions on https://apt.runonflux.io
Full Changelog: v9.0.0...v9.0.5
v9.0.4
What's Changed
- Fix rpc seg fault by @blondfrogs in #262
- Release v9.0.4 by @TheTrunk in #263
Full Changelog: v9.0.3...v9.0.4
v9.0.3
What's Changed
- fix undo data condition by @TheTrunk in #259
- Add debug file sizing, Add pon minter upgrades, add chainwork tiebreaker by @blondfrogs in #258
- Fix: Critical memory leak in FluxNode cache causing OOM crashes by @Cabecinha84 in #260
- Release v9.0.3 by @TheTrunk in #261
Full Changelog: v9.0.2...v9.0.3
v9.0.2
What's Changed
- fixes for chain by @blondfrogs in #256
- Release v9.0.2 by @TheTrunk in #257
Full Changelog: v9.0.1...v9.0.2
v9.0.1
v9.0.0
Flux v9.0.0 — Proof of Useful Work v2
A major network upgrade transitioning Flux from PoW mining to PoUW v2 via Proof of Nodes (PON). This release focuses on faster, smoother block production driven by the Fluxnode network, improved liveness, and a cleaner operational model.
Notable Changes
Network Fork
- Activation height (mainnet): 2,020,000
- Mandatory upgrade: all nodes must upgrade to v9.0.0 or later before the fork to remain on the main chain.
What Changed (High-Level)
- Consensus: Traditional PoW mining is no longer used. Blocks are produced via Proof of Nodes (PON) under the PoUW v2 design.
- Block cadence: Target block time set to 30 seconds with smoother difficulty adjustments for consistent throughput.
- Rewards: Initial PON block reward set to 14 FLUX, with scheduled annual reductions over the long term.
- Operational improvements:
- Streamlined Fluxnode operations, including support for trusted delegate operators (optional).
- Enhanced network liveness through a multi-signature emergency mechanism to recover block production in rare stall conditions.
What to Expect
- Faster confirmations and more predictable block intervals.
- No external PoW miners: mining software and pools are not used under PON.
- Existing wallets and infrastructure continue to function after upgrading.
Upgrade Guidance
- Update all nodes to v9.0.0+ and restart well before height 2,020,000.
- Monitor logs around fork height to confirm smooth transition.
- Infrastructure providers should ensure automation/tools are updated for 30s target blocks.
Acknowledgments
Thanks to everyone who contributed, reviewed, tested, and operated nodes during the development of PoUW v2 and the PON integration.
Whitepaper of PoUW v2
https://jetpack2_38080.app.runonflux.io/ipfs/QmW3TNPx5Ru3u3UhXf8GqyVNS3avSsttqjamhF395qe17M
How to Upgrade
Automatic Updates
If you're running a Flux node with automatic updates enabled, this release will be deployed automatically according to your update schedule.
Manual Installation
From Binary Releases:
- Download the appropriate binary for your platform from the GitHub releases page
- Stop your current Flux daemon:
flux-cli stop - Replace the old binaries with the new ones
- Restart your Flux daemon:
./fluxd -daemon
From Debian Package:
# Download and install the .deb package for your architecture
wget https://github.com/RunOnFlux/fluxd/releases/download/v9.0.0/flux-amd64-v9.0.0.deb
sudo dpkg -i flux-amd64-9.0.0.debBuilding from Source:
git clone https://github.com/RunOnFlux/fluxd.git
cd fluxd
git checkout v9.0.0
./zcutil/build.shUsing APT:
- Follow instructions on https://apt.runonflux.io
Important Notice: This is a mandatory fork release. All nodes must upgrade prior blockheight 2020000 estimated to be mined on the 25th of October 2025
Full Changelog: v8.0.0...v9.0.0
Flux v9.0.0-v9.0.0-18309762382
Merge pull request #253 from RunOnFlux/release-v9.0.0 Release v9.0.0
v8.0.0
Flux Daemon v8.0.0 is a major release that introduces removal of block reward halving, enhanced development infrastructure, and new features for network operators. This release includes breaking changes and users must upgrade in timely manner
Notable Changes
Removal of block reward halvings
- In preparation for upcoming network upgrade coming out Q4 2025 we are removing block reward halving
- This is to stabilize node infrastructure prior activating v9 fork
- In v9 of Flux Daemon we will be introducing dramatic changes to the entire ecosystem, more to be announced in the upcoming weeks
Discountinued 32-bit system builds
- We are discontinuing 32-bit system support
- i386 releases won't be shipped anymore
Faster Chain Analysis with getchaintips
- The
getchaintipsRPC call now accepts an optionalblockheightparameter - When specified, the analysis starts from the given block height instead of scanning the entire blockchain
- This dramatically reduces response time for recent chain analysis operations
- Useful for applications that only need to analyze recent blockchain activity
GitHub Actions CI/CD Integration
- Migrated from legacy CI systems to GitHub Actions for automated building and testing
- Improved cross-platform compilation support for AMD64, ARM64, and Windows
- Automated Debian package generation for multiple architectures
- Enhanced release artifact management and distribution
Cross-Compilation Improvements
- Fixed binary stripping for cross-compiled ARM64 binaries
- Added proper toolchain support for multi-architecture builds
- Improved MinGW-w64 Windows cross-compilation workflow
Arcane Mode Support
- Added
fArcaneflag for advanced benchmarking and testing scenarios - Activated via
UNMANAGED_FLUXBENCHDenvironment variable - Enables specialized node operation modes for development and testing
How to Upgrade
Automatic Updates
If you're running a Flux node with automatic updates enabled, this release will be deployed automatically according to your update schedule.
Manual Installation
From Binary Releases:
- Download the appropriate binary for your platform from the GitHub releases page
- Stop your current Flux daemon:
flux-cli stop - Replace the old binaries with the new ones
- Restart your Flux daemon:
./fluxd -daemon
From Debian Package:
# Download and install the .deb package for your architecture
wget https://github.com/RunOnFlux/fluxd/releases/download/v8.0.0/flux-amd64-v8.0.0.deb
sudo dpkg -i flux-amd64-8.0.0.debBuilding from Source:
git clone https://github.com/RunOnFlux/fluxd.git
cd fluxd
git checkout v8.0.0
./zcutil/build.shImportant Notice: This is a mandatory fork release. All nodes must upgrade prior blockheight 1968550 estimated to be mined on the 14th of August
Full Changelog: v7.2.0...v8.0.0
v7.2.0-gh-test
Gh action (#246) * adjust rust * adjust order * use rust 1.64 * test fix * disable rust * fix * disable i386, cross compile arm * improve arm strip