Products - MMFP Solutions

MIM Bootstrap - Complete Installation Guide

Complete mining infrastructure in 15 minutes. MIM Bootstrap is an automated deployment tool that sets up everything you need to run a professional Digibyte mining operation.

Note: MIM Bootstrap installs all MMFP products (AxeOS Dashboard, MIM, and supporting infrastructure). If you prefer to install components individually, see the individual product sections below.

What's Included

Digibyte Core 8.22.2 - Full blockchain node with pruning options
Mining Core - SHA256 mining pool software
PostgreSQL 18 - Database for pool statistics
AxeOS Dashboard - Real-time miner monitoring
MIM Dashboard - Infrastructure management interface
Dozzle - Container log viewer
Watchtower - Automatic container updates

Server Requirements

OS: Ubuntu Server 24 or 25 (minimal install recommended)
CPU: AMD64 or ARM64 Architecture, N150 or better
Memory: 16 GB or more
Swap: 20 GB minimum, 50GB maximum recommended
Storage: 65 GB minimum (1 TB recommended for full node)
Network: Stable internet connection

ARM64 Support: All components run natively on ARM64. Mining Core will run in QEMU emulation with minor performance impact.

Installation Part 1: Ubuntu Server Setup

These screenshots walk you through a minimal Ubuntu Server 25 installation. This provides a clean, optimized base for your mining infrastructure.

Important: Use the minimized installation option. This reduces disk usage and eliminates unnecessary packages.

Step 1: Boot from Ubuntu Server ISO

Boot from the Ubuntu Server installation media

Step 2: Select Language

Choose your preferred language

Step 3: Keyboard Configuration

Select your keyboard layout

Step 4: Installation Type - Select Minimized

Select "Ubuntu Server (minimized)" for optimal performance

Step 5: Network Configuration

Configure network settings (DHCP is fine for most setups)

Step 6: Proxy Configuration

Leave blank unless you're behind a corporate proxy

Step 7: Mirror Selection

Use default mirror or choose one closest to your location

Steps 8-10: Storage Configuration

Storage configuration - Use entire disk (default option works well)

Storage layout confirmation

Review partition layout and confirm to continue

Step 11: Profile Setup

Create your admin user account

Step 12: SSH Setup (Required!)

Important: Install OpenSSH server for remote management

Step 13: Featured Server Snaps

Skip all snaps - we'll use Docker instead

Step 14: Installation Progress

Wait for installation to complete (typically 5-10 minutes)

Step 15: Installation Complete

Remove installation media, reboot, and login

Installation Part 2: Docker Installation

Docker is required to run MIM Bootstrap and all mining infrastructure containers.

Remove Old Docker Versions

sudo apt-get remove docker docker-engine docker.io containerd runc

Update Package Index

sudo apt-get update

Install Prerequisites

sudo apt-get install ca-certificates curl

Add Docker's Official GPG Key

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

Add Docker Repository

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Update Package Index Again

sudo apt-get update

Install Docker Engine

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Verify Docker Installation

sudo docker run hello-world

If you see "Hello from Docker!" message, Docker is properly installed.

Note: For complete Docker documentation, visit: docs.docker.com/engine/install/ubuntu/

Installation Part 3: Launch MIM Bootstrap

Create the /data Directory

sudo mkdir -p /data

Pull the MIM Bootstrap Image

sudo docker pull ghcr.io/mmfpsolutions/mim-bootstrap:latest

Run MIM Bootstrap Container

sudo docker run -d \
  --name bootstrap \
  -p 3002:3002 \
  --restart unless-stopped \
  ghcr.io/mmfpsolutions/mim-bootstrap:latest

Command breakdown:

-d - Run in detached mode (background)
--name bootstrap - Name the container "bootstrap"
-p 3002:3002 - Map port 3002 to host
--restart unless-stopped - Auto-restart on reboot

Verify Container is Running

sudo docker ps

Installation Part 4: Access the Web Interface

Find Your Server IP Address

hostname -I | awk '{print $1}'

Open MIM Bootstrap in Your Browser

From any computer on your network:

http://YOUR-SERVER-IP:3002/setup

Complete the Setup Wizard

The wizard will guide you through 4 steps:

Server Access - SSH connection details
Passwords - Set passwords for MIM user, PostgreSQL, and Mining Core
Digibyte Settings - Configure RPC credentials and blockchain pruning
Review & Start - Confirm settings and begin automated deployment

Important: The bootstrap process will create a "mim" user on your server and install all infrastructure. This takes approximately 10-15 minutes.

After Installation

Once deployed, you'll have access to:

MIM Dashboard: http://YOUR-SERVER-IP:3001
AxeOS Dashboard: http://YOUR-SERVER-IP:3000
Dozzle (Logs): http://YOUR-SERVER-IP:8080

Point your AxeOS miners to port 5001 (or 5101 for low hashrate miners) to start mining!

AxeOS Dashboard

Real-time monitoring for your AxeOS miners. Track hashrates, worker status, pool statistics, and system health from one unified dashboard.

Note: AxeOS Dashboard is included in MIM Bootstrap. Install it separately only if you want a standalone monitoring solution.

Features

Live hashrate monitoring across all workers
Pool performance analytics
Digibyte Core node statistics
Mining Core integration
Historical data trending
Visual alert thresholds
Responsive web interface

Screenshots

Dashboard overview showing all connected miners

Detailed miner statistics and performance metrics

Mining Core pool statistics and worker status

Digibyte Core node statistics and blockchain info

Dashboard configuration and settings

Standalone Installation

Docker Run Command:

docker run -d \
  --name axeos-dashboard \
  --network host \
  -v ${PWD}/config:/app/config \
  -v ${PWD}/data:/app/data \
  ghcr.io/mmfpsolutions/axeos-dashboard:latest

Docker Compose

services:
  axeos-dashboard:
    image: ghcr.io/mmfpsolutions/axeos-dashboard:latest
    container_name: axeos-dashboard
    network_mode: host
    volumes:
      - ./config:/app/config
      - ./data:/app/data
    restart: unless-stopped

First-Time Setup

On first run, navigate to http://YOUR-SERVER-IP:3000 to access the bootstrap wizard. You'll be guided through:

Dashboard title and port configuration
Authentication settings (optional)
AxeOS device configuration
Mining Core integration (optional)
Digibyte Core node integration (optional)

After configuration, the dashboard will display real-time statistics from your configured miners and infrastructure.

MIM (Mining Infrastructure Manager)

Intelligent configuration and management tools. MIM provides a web-based interface for managing Digibyte Core nodes, Mining Core pools, and supporting infrastructure.

Note: MIM is included in MIM Bootstrap. Install it separately only if you need standalone infrastructure management without the full bootstrap suite.

Features

Web-based configuration interface
Digibyte Core node management
Mining Core pool configuration
Docker Compose orchestration
Real-time status monitoring
Configuration validation

What It Does

MIM simplifies complex infrastructure management by providing:

Configuration management: Store and manage multiple configuration profiles
Validation: Automatic validation of settings before deployment
Status monitoring: Real-time view of all infrastructure components

Standalone Installation

Docker Run Command:

docker run -d \
  --name mim \
  -p 3001:3001 \
  -v ${PWD}/config:/app/config \
  ghcr.io/mmfpsolutions/mim:latest

Docker Compose

services:
  mim:
    image: ghcr.io/mmfpsolutions/mim:latest
    container_name: mim
    ports:
      - "3001:3001"
    volumes:
      - ./config:/app/config
    restart: unless-stopped

Configuration

Before using MIM, you need to create a servers.json configuration file in the mapped config directory.

Create the config directory and servers.json file:

mkdir -p config
cat > config/servers.json << 'EOF'
{
  "servers": [
    {
      "name": "Mining Server",
      "ssh_host": "{SERVER_IP}",
      "ssh_port": 22,
      "ssh_user": "mim",
      "ssh_password": "{MIM_PASSWORD}",
      "docker_host": "ssh://mim@{SERVER_IP}",
      "enabled": true,
      "description": "MIM Configured Server"
    }
  ],
  "settings": {
    "ssh_timeout": 30,
    "docker_timeout": 30,
    "refresh_interval": 60
  }
}
EOF

Replace the following placeholders:

{SERVER_IP} - Your server's IP address
{MIM_PASSWORD} - SSH password for the mim user

Note: The mim user must exist on the target server with Docker permissions. When using MIM Bootstrap, this user is created automatically.

Access

After installation and configuration, access MIM at http://YOUR-SERVER-IP:3001

Frequently Asked Questions

General Questions

What's the difference between the products?

MIM Bootstrap: All-in-one automated installer that deploys the complete stack (AxeOS Dashboard + MIM + Digibyte Core + Mining Core + database + logging). Best for new users.
AxeOS Dashboard: Standalone monitoring dashboard for AxeOS miners. Use if you only need monitoring.
MIM: Standalone management interface for infrastructure configuration. Use if you only need configuration tools.

Which product should I use?

New to mining? Use MIM Bootstrap - it sets up everything automatically
Already have infrastructure? Use AxeOS Dashboard for monitoring or MIM for management
Just want to monitor miners? Use AxeOS Dashboard standalone

Are these products really free?

Yes! All MMFP Solutions products are free and open-source under the MIT license. You can use them commercially, modify them, and redistribute them. If they add value to your operation, voluntary donations are appreciated but never required.

Installation Questions

What are the system requirements?

For MIM Bootstrap (complete stack):

Ubuntu Server 24 or 25 (minimal install recommended)
CPU: AMD64 or ARM64 Architecture, N150 or better
Memory: 16 GB minimum
Swap: 20 GB minimum, 50 GB recommended
Storage: 65 GB minimum (1 TB recommended for full blockchain)
Network: Stable internet connection

For standalone products (AxeOS Dashboard or MIM):

Ubuntu Server 24 or 25 (or any Docker-compatible OS)
4GB RAM minimum
10GB disk space
Docker version 28.5.1+

ARM64 Support: All MMFP products support both AMD64 and ARM64 architectures. Mining Core will run in QEMU emulation on ARM64 with minor performance impact.

Do I need to install Docker first?

Yes. All products require Docker. See our installation guide for MIM Bootstrap or visit the official Docker Website.

Can I run this on a Raspberry Pi?

Yes! All MMFP products support ARM64 architecture and will run on Raspberry Pi 4/5 or other ARM-based systems. Mining Core will run in QEMU emulation with minor performance impact since it only supports AMD64 natively.

Why is the installation taking so long?

During MIM Bootstrap installation, the container downloading steps can take a considerable amount of time. Do not be alarmed - just wait.

The system is downloading all components for your mining infrastructure from the GitHub Container Repository. Installation time depends on:

Your internet connection speed
GitHub Container Repository performance
Your server's CPU, memory, and network interface speed

Even on a good internet connection, this can take 10-30 minutes or more. Be patient and let the process complete.

What if the installation fails?

If the install fails, no problem - just start over and do a reinstall:

Identify and correct the issue that caused the failure (network problems, insufficient disk space, etc.)
When reinstalling, select "Do not preserve anything" for a faster, cleaner installation
Consider enabling pruning if you aren't already using it - this reduces disk requirements significantly

Tip: Check the container logs in Dozzle or via docker logs bootstrap to see what went wrong during installation.

Post MIM Bootstrap Install

What happens after MIM Bootstrap finishes?

Once MIM Bootstrap completes, your infrastructure is up and running, but you cannot mine yet. Here's why:

Important: Mining Core will not accept connections until your Digibyte node is fully synchronized with the blockchain.

Your Digibyte Core node needs to download and validate the entire blockchain before Mining Core can start accepting miner connections. This synchronization process can take several hours to a few days depending on:

Your internet connection speed
Your server's CPU and disk performance
Whether you're running a pruned or full node
Network conditions and peer availability

See the "How can I see the status of my node synchronization?" question below for ways to monitor synchronization progress.

Configuration Questions

How do I configure AxeOS miners to use my pool?

After MIM Bootstrap installation, point your AxeOS miners to:

Regular miners: stratum+tcp://YOUR-SERVER-IP:5001
Low hashrate miners: stratum+tcp://YOUR-SERVER-IP:5101

Can I use an external wallet address?

Yes! You can configure your miner to use any valid Digibyte address for block rewards.

Should I run a pruned or full node?

Full node (recommended): Stores complete blockchain (~60-70GB). Better for network health and pool reliability.
Pruned node: Stores only recent blocks (~2-5GB). Good for limited disk space.

Troubleshooting

How can I see the status of my node synchronization?

After MIM Bootstrap installation, your Digibyte node needs to synchronize with the blockchain before mining can begin. There are several ways to check synchronization status:

AxeOS Dashboard: Open http://YOUR-SERVER-IP:3000, scroll to the bottom and look at Crypto Node Status
- Note: AxeOS Dashboard requires at least one AxeOS device configured. It will ask you for this on first load.
Dozzle (Container Logs): Open http://YOUR-SERVER-IP:8080
- Find the "dgb" link and click it to view your Digibyte node logs
- Find the "miningcore" link to see if Mining Core is waiting for node synchronization
MIM Dashboard: Open http://YOUR-SERVER-IP:3001
- If you see the dgb Docker container running at high CPU load (90-100%+), your node is likely still synchronizing

Note: Mining Core will not accept connections until your Digibyte node is fully synchronized.

Container won't start

Check container logs:

sudo docker logs [container-name]

Can't access the web interface

Verify the container is running: sudo docker ps
Check firewall isn't blocking the port
Ensure you're using http:// not https://
Try accessing from the server itself: curl http://localhost:PORT

Database connection errors

If Mining Core can't connect to PostgreSQL, ensure the database container is running and healthy. Check with:

sudo docker ps
sudo docker logs postgres

Support

Where can I get help?

GitHub Issues: Report bugs or request features at github.com/mmfpsolutions
Documentation: Check product README files for detailed guides
Community: Visit our Support page for community resources

How can I contribute?

Contributions are welcome! You can:

Submit bug reports or feature requests on GitHub
Contribute code improvements via pull requests
Improve documentation
Support the project with a donation (see Support page)
Share your experience with other miners