Proto Fleet

Mining management software. Evolved.

No fees. No training. Full control.
Open source fleet management for bitcoin miners.

Proto Fleet is open-source fleet management software for bitcoin miners. It helps operators pair devices, monitor telemetry, and manage mining infrastructure without giving up control. Built with React and TypeScript clients, Go services, Connect RPC, Protocol Buffers, and TimescaleDB. For architecture details, see docs/architecture.md.

Install

Proto Fleet deploys into Docker on Linux and macOS, or into WSL2 on Windows.

Linux and macOS

Requires Docker and Docker Compose. On macOS (and Windows via Docker Desktop), enable host networking under Settings → Resources → Network → Enable host networking. See deployment-files/README.md for the full prerequisites.

Latest Version

bash <(curl -fsSL https://fleet.proto.xyz/install.sh)

Specific Version

bash <(curl -fsSL https://fleet.proto.xyz/install.sh) v0.1.0

Uninstall

bash <(curl -fsSL https://fleet.proto.xyz/uninstall.sh)

If Proto Fleet was installed in a non-default location, pass it explicitly:

bash <(curl -fsSL https://fleet.proto.xyz/uninstall.sh) --deployment-path /path/to/install/root

Windows

Requires Windows 10 (build 19041 or newer) or Windows 11 (x64), local Administrator access, and virtualization enabled in BIOS/UEFI. Docker Desktop is not required — the installer enables WSL2, installs an Ubuntu distro and Docker Engine inside it, and deploys Proto Fleet at ~/proto-fleet within the distro.

installer.exe is not standalone. It resolves the deployment payload from files packaged alongside it in the release bundle, so you need to download and extract the full bundle before running it. Windows is supported on x64 only.

1. Go to the latest release and download proto-fleet-<version>-amd64.tar.gz.

2. Extract the archive. From PowerShell:

   tar -xzf proto-fleet-<version>-amd64.tar.gz

   Or right-click the file in File Explorer and choose Extract All.

3. Open the extracted deployment\install\ folder and double-click installer.exe.

The installer self-elevates via UAC. If it has to enable Windows features for WSL, it may prompt for a reboot and then resume automatically.

Uninstall

Run uninstall.exe from the deployment\install\ folder of the bundle you extracted during install. If you no longer have it, re-download and extract the latest release bundle and use the uninstall.exe inside it.

For Windows installer/uninstaller build and test details, see deployment-files/windows/README.md.

Supported Hardware

Per-device feature support.

• ✅ — supported and tested.
• ❌ — not supported.
• 🟡 — supported by asic-rs, but not yet tested on this combination.

Manufacturer	Proto	MicroBT	Bitmain					Canaan	Bitaxe	NerdAxe	ePIC	Auradine
Model line	Rig	WhatsMiner	Antminer					AvalonMiner	BitAxe	NerdAxe	ePIC	Auradine
Firmware	ProtoOS	Stock	Stock	VNish	Braiins OS	LuxOS	Marathon	Stock	AxeOS	Stock	Stock	Stock
Telemetry	✅	✅	✅	✅	✅	✅	🟡	✅	🟡	🟡	🟡	🟡
Reboot	✅	✅	✅	✅	🟡	🟡	🟡	🟡	🟡	🟡	🟡	🟡
Pause/Resume	✅	✅	✅	✅	🟡	🟡	🟡	🟡	🟡	🟡	🟡	🟡
Edit Pools	✅	✅	✅	✅	🟡	🟡	🟡	🟡	🟡	🟡	🟡	🟡
FW Update	✅	❌	✅	❌	❌	❌	❌	❌	❌	❌	❌	❌
Power Mode	✅	✅	✅	✅	🟡	🟡	🟡	🟡	🟡	🟡	🟡	🟡
Cooling Mode	✅	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌	❌
Update Password	✅	❌	✅	❌	❌	❌	❌	❌	❌	❌	❌	❌
Download Logs	✅	❌	✅	❌	❌	❌	❌	❌	❌	❌	❌	❌
Blink LED	✅	✅	✅	✅	🟡	🟡	🟡	🟡	🟡	🟡	🟡	🟡

Powered by asic-rs

Multi-manufacturer miner support in Proto Fleet is built on top of asic-rs, a Rust library from the 256 Foundation that abstracts discovery, monitoring, and control across ASIC miner vendors and firmwares. It is the reason the 🟡 cells above exist at all: every new vendor or firmware that asic-rs learns to speak is one that Proto Fleet can drive with no extra plugin work.

If you work on miner firmware or operate a heterogeneous fleet, go give them a star. Upstream contributions to asic-rs flow straight back into Proto Fleet via the plugin/asicrs/ plugin.

Local Development

Prerequisites

• Docker and Docker Compose
• Hermit (recommended) — activates the full toolchain. For a manual tool setup, see CONTRIBUTING.md.

Initial Setup

source ./bin/activate-hermit
just setup

To install Git hooks after your toolchain is ready:

just install-hooks

For lefthook and Ruff hook prerequisites and go.work guidance, see CONTRIBUTING.md.

Start Development

just dev

This starts the Go backend with Docker Compose and the Vite dev server for ProtoFleet at http://localhost:5173.

Protocol Buffer Code Generation

After modifying definitions in proto/, regenerate generated clients and server code:

just gen

Contributing

See CONTRIBUTING.md for development workflows and contribution guidelines. Project standards and community expectations are documented in CODE_OF_CONDUCT.md, GOVERNANCE.md, and SECURITY.md.

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.