Skip to content
forked from ShaeOJ/AxeOS-VPN

Vault-Tec Mining Operations Division - BitAxe Monitoring System

Notifications You must be signed in to change notification settings

Ohio82/AxeOS-VPN

 
 

Repository files navigation

╔══════════════════════════════════════════════════════════════════════════════╗
║                                                                              ║
║     █████╗ ██╗  ██╗███████╗ ██████╗ ███████╗    ██╗   ██╗██████╗ ███╗   ██╗  ║
║    ██╔══██╗╚██╗██╔╝██╔════╝██╔═══██╗██╔════╝    ██║   ██║██╔══██╗████╗  ██║  ║
║    ███████║ ╚███╔╝ █████╗  ██║   ██║███████╗    ██║   ██║██████╔╝██╔██╗ ██║  ║
║    ██╔══██║ ██╔██╗ ██╔══╝  ██║   ██║╚════██║    ╚██╗ ██╔╝██╔═══╝ ██║╚██╗██║  ║
║    ██║  ██║██╔╝ ██╗███████╗╚██████╔╝███████║     ╚████╔╝ ██║     ██║ ╚████║  ║
║    ╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝ ╚═════╝ ╚══════╝      ╚═══╝  ╚═╝     ╚═╝  ╚═══╝  ║
║                                                                              ║
║                    VAULT-TEC MINING OPERATIONS DIVISION                      ║
║                      "Preparing for the Future, Today!"                      ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝

🏭 AxeOS VPN Monitor

VAULT-TEC APPROVED | Mining Rig Monitoring System | Est. 2077

Welcome, Vault Dweller! You've discovered the AxeOS VPN Monitor - Vault-Tec's premier solution for monitoring your Bitcoin mining operations from the safety of your underground bunker (or anywhere else in the wasteland).


📟 TERMINAL STATUS: ONLINE

[VAULT-TEC SYSTEMS DIAGNOSTIC]
├── Desktop App ............ OPERATIONAL ✓
├── Mobile App ............. OPERATIONAL ✓
├── Web Dashboard .......... OPERATIONAL ✓
├── ClusterAxe Support ..... OPERATIONAL ✓
└── Remote Access .......... OPERATIONAL ✓

🎯 What Does It Do?

AxeOS VPN Monitor is a complete monitoring solution for BitAxe and compatible mining devices:

Feature Description
📊 Real-time Metrics Hashrate, temperature, power, efficiency - all at a glance
🌡️ Thermal Monitoring Color-coded alerts: Green (safe) → Orange (warm) → Red (DANGER)
🔗 ClusterAxe Support Monitor entire mining clusters as a single unit
🌐 Remote Access Cloudflare Tunnel integration - access from anywhere
📱 QR Code Access Scan with your Pip-Boy (phone) for instant remote access
Network FX Beautiful animated particle network background (toggle on/off)

🖥️ Supported Devices

┌────────────────────────────────────────────┐
│         COMPATIBLE MINING UNITS            │
├────────────────────────────────────────────┤
│  ✓ BitAxe Ultra                            │
│  ✓ BitAxe Gamma                            │
│  ✓ BitAxe Supra                            │
│  ✓ BitAxe Hex                              │
│  ✓ NerdAxe / NerdQAxe                      │
│  ✓ ClusterAxe (Master + Slaves)            │
│  ✓ Any AxeOS-compatible device             │
└────────────────────────────────────────────┘

🚀 Quick Start

Prerequisites

  • Node.js 18+ (the reactor core)
  • PNPM 8+ (package containment system)
  • A BitAxe or compatible device on your network

Installation

# Clone this vault
git clone https://github.com/YOUR_USERNAME/AxeOS-VPN.git
cd AxeOS-VPN

# Initialize containment protocols
pnpm install

# Launch the reactor
pnpm dev

The desktop app will open automatically. Add your mining devices by IP address and watch the hashrate flow!


📸 Screenshots

Desktop Dashboard

Vault-Tec approved interface with real-time metrics

Web Remote Access

Access your miners from any terminal in the wasteland

Mobile App

Monitor on the go with your Pip-Boy 3000 (or smartphone)


🏗️ Project Structure

axeos-vpn/
├── apps/
│   ├── desktop/          # Electron app (Win/Mac/Linux)
│   │   ├── main/         # Main process + local server
│   │   └── renderer/     # React UI
│   └── mobile/           # React Native (iOS/Android)
├── packages/
│   ├── shared-types/     # TypeScript interfaces
│   └── shared-utils/     # Utility functions
└── README.md             # You are here, Vault Dweller

🔧 Features in Detail

🌐 Remote Access (Cloudflare Tunnel)

Access your mining dashboard from anywhere - no port forwarding required!

  1. Go to SettingsRemote Access
  2. Click Enable Remote Access
  3. Scan the QR code with your phone
  4. Monitor from anywhere in the wasteland!

📊 Efficiency Tracking

AxeOS VPN calculates J/TH (Joules per Terahash) for all your devices:

  • Lower is better
  • Helps identify underperforming units
  • Works even if your device doesn't report it natively

✨ Network Animation (FX Mode)

Toggle the beautiful particle network background:

  • Click the FX button in the web dashboard header
  • Nodes pulse and connect in real-time
  • Looks cool, makes you feel like a Vault-Tec engineer

🛠️ Development

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Type checking
pnpm typecheck

📜 Vault-Tec Legal Notice

╔══════════════════════════════════════════════════════════════════╗
║                    VAULT-TEC CORPORATION                         ║
║              "Building a Better Tomorrow, Underground"           ║
╠══════════════════════════════════════════════════════════════════╣
║                                                                  ║
║  This software is provided "AS IS" without warranty of any      ║
║  kind. Vault-Tec is not responsible for:                        ║
║                                                                  ║
║  • Overheated mining rigs                                        ║
║  • Insufficient hashrate                                         ║
║  • Radiation exposure from extended terminal use                 ║
║  • Addiction to watching numbers go up                           ║
║  • Any incidents involving Deathclaws                            ║
║                                                                  ║
║  By using this software, you agree that Bitcoin mining           ║
║  is essential for post-apocalyptic economic recovery.            ║
║                                                                  ║
╚══════════════════════════════════════════════════════════════════╝

🤝 Contributing

Pull requests welcome! Whether you're from Vault 101 or the Capital Wasteland, we appreciate all contributions.


📄 License

MIT License - Free as in Freedom (and bottle caps)


Built with ☢️ by Vault-Tec Mining Operations Division
"When the bombs fall, keep hashing!"

About

Vault-Tec Mining Operations Division - BitAxe Monitoring System

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 93.4%
  • CSS 3.3%
  • JavaScript 3.0%
  • Other 0.3%