Operational Best Practices

This guide consolidates recommended practices for operating Bitcoin mining infrastructure with MiningOS. Following these guidelines helps maximize uptime, simplify troubleshooting, and maintain accurate inventory records.

For system architecture and design principles, see Architecture. For initial setup, see Installation Guide.

---

Quick Navigation

---

Monitoring & Alerts

Maintain Alert Visibility

Keep a dedicated browser tab open on the Alerts page to receive audio notifications for critical events. Sound notifications only trigger when this page is active.

For alert severity definitions, see Alerts Manual — Severity Levels.

Monitor Header Metrics

Regularly scan the header bar for anomalies:

Investigate Status Colors

When miners appear in orange (major errors) or red (offline) categories, use the Explorer to diagnose and address issues promptly.

For power mode capabilities by model, see Power Mode Support Table.

Track Efficiency Trends

The W/TH/s metric displayed in the Header and Dashboard serves as an early warning system for:

For temperature visualization, see Heatmaps.

---

Inventory Management

Review Current Site Daily

The donut chart panels in Current Site Overview provide rapid visual assessment of inventory health.

For status definitions, see Miners Inventory — Status Selector.

Balance Distribution

Use the Miner Distribution table to identify deployment bottlenecks:

For capacity planning, see Miner Distribution — Capacity Planning.

Leverage Inline Editing

The Miners Inventory table supports direct Location and Status updates without navigating to detail views. This enables efficient bulk management during:

• Receiving new equipment
• Physical inventory audits
• Status reconciliation exercises
• Location updates after moves

For location definitions, see Miners Inventory — Location Selector.

Audit Unknown Locations

Miners showing "Unknown" location require physical verification:

1. Filter for Unknown in Miners Inventory
2. Review Movement History via Actions menu → Inventory Logs
3. Check last known location in Historical Movements
4. Physically locate the equipment
5. Update location using inline dropdown
6. Document findings via Comments

For movement tracking, see Historical Device Movements.

---

Spare Parts & Repairs

Track Recovered Parts

The "Recovered" status unique to Spare Parts Inventory enables accurate cost accounting for salvaged components.

For status definitions, see Spare Parts — Status Selector.

Use Bulk Import for Large Shipments

When receiving large component shipments:

1. Download CSV template from Bulk Add Parts
2. Populate with shipment data using consistent formatting
3. Validate before import — check serial numbers and model codes
4. Import via Bulk register button
5. Verify import by filtering for newly added parts

For CSV template format, see Spare Parts — CSV Template.

Monitor Part Associations

Regularly review the Miner Code column in Spare Parts Inventory to identify:

Document Repairs

Use the Comments feature to record:

For repair workflow, see Repair History.

---

Container Operations

Verify Cooling Systems Before Mining

Always confirm cooling systems are operational before enabling miners:

For container-specific alerts, see Alerts Manual — Visual Alerts by Container Type.

Monitor Temperature Heatmaps

Use the Heatmaps feature regularly to identify:

For temperature metrics, see Heatmaps — Temperature Metrics.

Configure Pools Correctly

Always configure mining pools through MiningOS using the Pool Manager, not vendor tools:

For pool configuration warnings, see Bitdeer Container — Pool Configuration.

---

Pool Management

Configure Failover Pools

Always set up at least one failover endpoint for each pool:

For endpoint configuration, see Pool Manager — Pool Endpoints.

Use Sleep Mode for Reconfiguration

When changing pool assignments, place miners in sleep mode first:

1. Select miners in Pool Manager — Sites Overview
2. Set to Sleep mode via Explorer
3. Configure new pool via Setup Pools
4. Return to Normal mode after configuration

For model-specific sleep mode availability, see Power Mode Support Table.

Monitor Pool Connectivity

Check the header bar's Pool indicator regularly:

For pool-related alerts, see Pool Manager — Alerts Integration.

---

Administrative Tasks

Follow Approval Workflows

Double-authorization actions require proper approval:

Review the Requests & Approvals workflow before submitting critical operations.

Manage User Permissions

Regularly audit user roles in Settings:

For role definitions, see Settings — User Roles.

Use Backend Operations Carefully

Backend Operations like firmware updates require careful planning:

---

Daily Operations Checklist

---

Related Documentation

Operator Manual

• Introduction — MiningOS overview and supported hardware
• Dashboard — Main monitoring dashboard
• Explorer — Device search and management
• Alerts Manual — Complete alert reference
• Pool Manager — Mining pool configuration
• Inventory Module — Fleet management capabilities
• Settings — User and system configuration

Architecture & Installation

• Architecture — System design and component relationships
• Installation Guide — Setup and configuration
• Supported Devices — Hardware compatibility

Contributor Guide

• Repository Structure — Codebase organization
• Testing & Linting — Quality assurance
• Code Documentation — Documentation standards

External Resources

• Bitmain Support — Antminer documentation and firmware
• MicroBT Official — Whatsminer support resources
• Canaan Shop — Avalon product information
• Ocean Pool — Ocean mining pool dashboard
• F2Pool — F2Pool mining statistics