HashCore Toolkit Documentation

Comprehensive documentation for HashCore Toolkit. Learn how to use advanced features, configure settings, and optimize your ASIC mining farm management.

This guide covers common operations, configuration options, and troubleshooting techniques used by professional mining operators.

Basic Operations

Device Discovery

HashCore automatically scans your network to discover ASIC miners. To manually initiate discovery:

  1. Navigate to Devices → Discover
  2. Enter the IP range to scan (e.g., 192.168.1.0/24)
  3. Click "Start Scan"
  4. Review discovered devices and add to inventory

Discovery uses standard protocols (CGMiner API, mDNS) to identify miners without requiring credentials until device addition.

Monitoring Miners

Once added, miners appear in the main dashboard showing real-time status. Key metrics include:

  • Hashrate (current, average, expected)
  • Temperature (chip, board, ambient)
  • Power consumption (per device, per hash board)
  • Fan speed and cooling efficiency
  • Pool connectivity and share statistics
  • Hardware errors and reject rate

Click any device for detailed diagnostics including per-chip statistics and historical performance graphs.

Bulk Operations

Execute operations across multiple devices simultaneously. Select devices and choose an action:

  • Restart: Reboot selected miners (useful after pool changes)
  • Configure Pools: Apply pool settings to multiple devices
  • Update Firmware: Deploy firmware to selected miners
  • Adjust Frequency: Tune mining frequency for power/performance balance
  • Group Assignment: Organize miners into logical groups

Bulk operations queue and execute in parallel with configurable concurrency limits to prevent network overload.

Alert Configuration

Set up automated alerts for critical conditions. Navigate to Settings → Alerts to configure:

  • Temperature Thresholds: Alert when devices exceed safe operating temperatures
  • Hashrate Drops: Notify when performance falls below expected levels
  • Device Offline: Immediate alerts when miners become unreachable
  • Pool Failures: Warn when pool connectivity is lost
  • High Reject Rate: Alert on excessive rejected shares

Alerts can trigger email notifications, push notifications (mobile), or webhook calls for integration with external systems.

Configuration Options

Network Settings

Configure how HashCore discovers and communicates with miners. Access via Settings → Network.

  • Discovery Ranges: Define IP ranges for automatic scanning
  • Polling Interval: How frequently to query miner status (default: 60 seconds)
  • Connection Timeout: Maximum wait time for miner responses
  • Concurrent Operations: Parallel thread limit for bulk actions
  • API Port: Port for CGMiner API communication (default: 4028)

Data Retention

Control how long historical data is retained. Configure via Settings → Data Management.

  • Raw Metrics: High-resolution data (default: 7 days)
  • Aggregated Data: Hourly summaries (default: 90 days)
  • Audit Logs: User action logs (default: 1 year)
  • Device Events: Status changes and alerts (default: 30 days)

Longer retention requires more storage. Export data before retention limits expire if long-term archival is needed.

User Management

Create user accounts with specific permissions. See security documentation for detailed access control options.

  • Admin: Full access to all features
  • Operator: Can view, restart, and configure miners
  • Viewer: Read-only access to dashboards and reports
  • Custom: Define specific permission combinations

Advanced Usage

API Access

HashCore provides a REST API for integration with external systems. Enable API access in Settings → API.

Example API endpoint for device list:

GET /api/v1/devices

API authentication uses bearer tokens. Generate tokens in the user settings panel.

Multi-Instance Deployment

For operations exceeding 50,000 devices or spanning multiple locations, deploy multiple HashCore instances. Each instance manages a subset of devices with optional central coordination via HashCore Pulse.

See architecture documentation for deployment patterns and scalability guidance.

Integration with HashCore Ecosystem

HashCore Toolkit integrates with other HashCore products for enhanced functionality:

  • HashCore Firmware: Deploy performance-optimized firmware (24% gain)
  • HashCore Proxy: Optimize pool connectivity and reduce latency
  • HashCore Pulse: Enterprise orchestration for multi-site operations

Need additional help or have questions?