Install MiningOS

MiningOS is deployed as a set of microservices that communicate over Holepunch RPC. The frontend UI uses React and connects to backend services through an API Gateway. The API Gateway handles request routing, authentication, and access control. The backend services use Node.js, expose RPC endpoints and encapsulate business logic, data processing, and internal service-to-service communication.

Architecture Overview

The following installation guide covers all the MiningOS microservices that include:

1. Services Orchestrator (miningos-wrk-ork)

2. React Web UI (miningos-app-ui)

3. HTTP API Gateway (miningos-app-node)

4. AntMiner Miners (miningos-wrk-miner-antminer)

5. Avalon Miners (miningos-wrk-miner-avalon)

6. Whatsminer Miners (miningos-wrk-miner-whatsminer)

7. Antspace Containers (miningos-wrk-container-antspace)

8. Bitdeer Containers (miningos-wrk-container-bitdeer)

9. MicroBT Containers (miningos-wrk-container-microbt)

10. ABB Powermeters (miningos-wrk-powermeter-abb)

11. Schneider Powermeters (miningos-wrk-powermeter-schneider)

12. Satec Powermeters (miningos-wrk-powermeter-satec)

13. Seneca Temperature Sensor (miningos-wrk-sensor-temp-seneca)

14. Inventory Management (miningos-wrk-inventory)

15. Ocean Mining Pool (miningos-wrk-minerpool-ocean)

16. F2Pool Mining Pool (miningos-wrk-minerpool-f2pool)

17. Mempool (miningos-wrk-ext-mempool)

18. OpenWeather (miningos-wrk-ext-openweather)

19. Electricity Base (miningos-wrk-electricity-base)

Total: 19 worker types + mock servers(development environment)

Prerequisites

System Requirements

Operating System:

• Ubuntu

• macOS

• Windows

Hardware (Minimum for Development):

• 4+ CPU cores

• 8GB+ RAM

• 32GB available disk space

Hardware (Recommended for Production):

• 8+ CPU cores

• 16GB+ RAM

• 128GB+ SSD storage

Software Requirements

Required:

• Node.js >= 20.0 (LTS recommended)

• npm >= 10.0 (comes with Node.js)

• git

• pm2 (npm install -g pm2)

• HP RPC (npm install -g hp-rpc-cli)

Update all worker commands to use the production environment on the production server (currently set to development).

Create a Working Directory

Before you begin the installation process, create a working directory using the following command:

mkdir mining-os

Use the same working directory for all the workers.