fluxrig
fluxrig is a connectivity and protocol orchestration platform for distributed mission-critical infrastructure.
It provides a unified control plane to route, transform, and monitor data streams across heterogeneous environments, from industrial IoT sensors to global payment networks. The routing and transformation logic is declarative configuration, which holds as much for a flow being designed now as for one that has been in production for a decade.
A Rack is an edge node running a scenario: a YAML description of processing steps and how they are wired. The Mixer enrolls Racks, deploys scenarios to them, and collects their telemetry. A Rack keeps processing while the Mixer is unreachable.
TIP
Start with the 5-Minute Quickstart, or read the Architecture Overview and the use cases.
Why fluxrig?
fluxrig is designed for environments where data integrity and edge autonomy are non-negotiable.
- One control plane for many edge nodes: Racks enroll themselves, receive scenarios, and report telemetry to a single Mixer.
- Protocol Agnostic: A native ISO 8583 codec whose dialects are described by a spec rather than by code, generic TCP framing for binary protocols, and JSON and the rest through Bento mappings.
- Configuration over Code: Deploy complex routing and transformation logic via declarative YAML: no custom coding required for standard integrations.
- Sovereign Autonomy: Edge nodes operate independently, ensuring business continuity even during backhaul outages.
Design philosophy: The professional audio logic
We borrow our architectural nomenclature from professional audio engineering to describe complex data flows with both precision and scale:
- The Gear: A modular unit of logic (an ISO 8583 codec, a Bloblang mapping, a Wasm module of your own).
- The Rack: An edge node that hosts and executes multiple Gears (like a stage rack).
- The Mixer: The central Front of House (FOH) control plane that manages the fleet and aggregates telemetry.
Technical Architecture
Core Entities
| Entity | Technical Role | Analogy |
|---|---|---|
| Mixer | Central control plane and entity registry. | Mixing Console |
| Rack | Distributed edge node executing local logic. | Equipment Rack |
| Gear | Modular functional unit (Native or Wasm). | Effect Pedal |
| Wire | Persistent, ordered message queue (NATS). | Signal Path |
| Snake | Secure, multiplexed mTLS tunnel. | Audio Snake |
| fluxMsg | Standardized internal data structure (CBOR). | High-Fi Signal |
Choose your journey
For Operators & SREs
Maintain maximum uptime and operational visibility. fluxrig provides the tools to orchestrate distributed racks, manage immutable snapshots, and analyze telemetry in real time.
- Deployment architecture & binaries →
- Operations & CLI reference →
- Technical configuration (Mixer/Rack) →
- Telemetry & analytics guide →
For Developers & SDK Users
Build specialized processing logic with minimal overhead. Leverage the Native Go SDK to create custom protocol drivers or use the declarative Bento Gear for high-speed message transformation.
- Writing your first Native Gear →
- SDK reference & contract →
- Bento Gear declarative logic →
- Gears ecosystem reference →
For Architects & Security Teams
Design resilient, sovereign data planes. fluxrig allows for the design of complex, multi-actor topologies that enforce strict data isolation, zero-trust connectivity, and deterministic execution.
- System foundation & core principles →
- Security & identity architecture →
- Network & message flow integrity →
- Industry use case spectrums →
