🐳 Byte-Yield Cluster

High-Performance Passive Income Stack for Docker

Architecture • Networks • Installation • Monitoring

---

📖 Overview

Byte-Yield is an enterprise-grade Docker Compose stack designed to monetize unused internet bandwidth and system resources. Unlike scattered scripts or manual setups, Byte-Yield provides a unified, multi-architecture infrastructure that deploys instantly on Raspberry Pi (ARM64), Linux (x86), and Windows.

✨ Key Features

• ⚡ Multi-Architecture: Native support for ARM64 and AMD64 with automatic hardware detection.
• 🔒 Security First: Curated list of networks. Strictly no MystNodes (Mysterium) due to security/legal risks.
• 🛠 Automated Init: Includes smart scripts to generate UUIDs and configure environments automatically.
• 📦 Custom Optimized Images: Includes custom-built, lightweight images for PacketShare and Honeygain Autoclaim where official images fall short.

---

💾 Architecture

This stack utilizes a clean, modular structure to organize services and scripts.

byte-yield/
├── containers/             # Docker Compose files
│   ├── network.yml         # Main stack (Honeygain, Pawns, EarnApp, etc.)
│   ├── extensions.yml      # Browser Node stack (Chromium for Titan, Kaisar, etc.)
│   └── .env.example        # Template for environment variables
├── packetshare/            # Custom Build Contexts
│   ├── arm/                # Dockerfile for Raspberry Pi/ARM
│   └── x86/                # Dockerfile for Standard PC/AMD64
├── setup/                  # Automation Scripts
│   ├── docker.sh           # Installs Docker engine & Compose
│   └── init.sh             # Generates env vars, detects CPU, sets up UUIDs

Note: I utilize a custom Docker image for PacketShare (tadeh85/packetshare) to resolve stability issues present in the official image. Source Dockerfiles are included in the repo for those who wish to build locally. Wiki

---

📡 Supported Networks

Transparency Note: This project is free and open-source. The links below are referral links, which help support the maintenance of this repository. Using them often grants you a starting bonus (e.g., $5 on Honeygain).

🐳 Main Containers (network.yml)

Network Container	Function	Payout Methods
Honeygain	Bandwidth Sharing	PayPal, JMPT (Crypto)
Pawns.app	Bandwidth & Surveys	PayPal, Bitcoin, Gift Cards
EarnApp	Bandwidth Sharing	PayPal, Amazon Gift Cards
Traffmonetizer	Traffic Monetization	USDT, BTC, Payoneer
Bitping	Network Monitoring	Bitcoin (Lightning), DRIP
Repocket	Bandwidth Sharing	PayPal, Wise
EarnFM	Bandwidth Sharing	Crypto
Antgain	Bandwidth Sharing	PayPal, Crypto, Gift Cards
PacketShare ⚠️	Bandwidth Sharing	PayPal

⚠️ Service Alert (Jan 29, 2026): PacketShare is currently experiencing significant stability issues and network errors. While the container is included for completeness, you may experience connection failures until the provider resolves their backend issues.

🚫 A Note on MystNodes (Mysterium)

You will notice MystNodes is explicitly excluded from this repository. While popular, recent reports have highlighted significant legal and ethical risks regarding the traffic allowed on their network.

• Reason: Reports of Child Exploitation Material (CSAM) distribution via MystNodes exit nodes.
• Policy: For the safety of the host (you), this container is not included.

---

🌐 Browser-Based Nodes (extensions.yml)

Some newer DePIN networks only run as Browser Extensions. To run these in a headless Docker environment (like a VPS or Raspberry Pi), we use a Chromium container with a web-accessible GUI.

Extension	Function	Link
Titan Network	Bandwidth/Compute	Install Extension
Kaisar Network	Decentralized AI Compute	Install Extension
Bless Network	Bandwidth Sharing	Install Extension

Setup: These run inside the chrome container listed below. You must open the browser GUI (http://your-ip:5800) and install them manually.

---

🚀 Installation

1. Prerequisites

If you are on a fresh Linux / Raspberry Pi install, use our helper script to install Docker and prepare the directory:

chmod +x ./setup/docker.sh
./setup/docker.sh

2. Setup & Configuration

Clone the repository and run the initialization script. This script will detect your CPU architecture (ARM vs x86) and generate necessary UUIDs for you.

git clone [https://github.com/tadeh85/byte-yield.git](https://github.com/tadeh85/byte-yield.git)
cd byte-yield

# Run the magic setup script
chmod +x ./setup/init.sh
./setup/init.sh

3. Edit Credentials

Open the generated environment file and fill in your emails, tokens, and passwords.

nano .env

4. Deploy

To run the Main Network Stack:

docker compose -f containers/network.yml up -d

To run the Browser Extension Stack:

docker compose -f containers/extensions.yml up -d

Access the Browser GUI at http://your-ip:5800 to install extensions.

---

📊 Optional: Tools & Monitoring

I have included a tools folder containing a separate Compose file for useful utilities:

• Dozzle: A real-time log viewer for your containers (view logs in your browser).

• Glances: A web-based system monitor to check CPU/RAM usage.

To run these tools:

cd tools
docker compose up -d

Dozzle will be available at http://localhost:8080 and Glances at http://localhost:61208

---

⚙️ Advanced Configuration

Wiki

For detailed configuration guides on specific applications, please refer to the Project Wiki.

Building PacketShare Locally

If you prefer not to use the pre-built tadeh85/packetshare image, you can build it from source:

# For x86 systems
docker build -t local/packetshare ./x86/packetshare/

# For ARM systems
docker build -t local/packetshare ./arm/packetshare/

Update your docker-compose.yml to use image: local/packetshare.

---

⚠️ Disclaimer

This software is provided "as is", without warranty of any kind.

• ISP Terms: Ensure your Internet Service Provider (ISP) permits bandwidth sharing.

• Liability: The author is not responsible for any account bans, network usage overages, or ISP disputes resulting from the use of this stack.

🐛 Report a Bug • ⭐ Star this Repo