Getting started

Requirements

To run a Minera system you need some kind of hardware running Linux Debian (or any Debian based distribution).

Minera image file is built to run on any Raspberry PI model.

If you want to run it in a different hardware please check the manual install.

For standard install (Raspberry) you need a SD Card with at least 4GB.

Standard install

The recommended and simplest way to get your Minera system is using the image file.

• Download the latest release
• Unzip it
• Put the image into your SD Card (specific software required, read below)
• Insert the SD Card into your Raspberry
• Turn on your Raspberry
• Find the Raspberry IP
• Go to http://[raspberry-ip]/minera/

Flashing the SD Card

Windows -> If you are on Windows you can use Win32DiskImager

Mac OS X -> If you are on a Mac OS X you can use ApplePi-Baker

Linux -> If you are on Linux you can use ImageWriter or the command line below.

dd bs=4M if=minera-latest.img of=/dev/your-sd-card

Manual install

Prepare

You can simply install Minera on your current Linux controller. Check if it's Debian based otherwise download and install a right distribution like Ubuntu.

When you have your system ready, ssh into it and install Minera.

Skip this step and continue below if you have a web server with PHP installed.

sudo apt-get install -y lighttpd php5-cgi
sudo lighty-enable-mod fastcgi
sudo lighty-enable-mod fastcgi-php
sudo service lighttpd force-reload

Install

When your web server is ready you can install Minera:

sudo apt-get install -y redis-server git screen php5-cli php5-curl
cd /var/www
sudo git clone https://github.com/michelem09/minera
cd minera
sudo ./install_minera.sh

The installer will configure the system requirements and will tell you the URL to connect to.

Default URL: http://[your-minera-ip]/minera/ Default password: minera

Important: minera system user has password "minera", you should change it if your system is a public host with SSH access.

sudo passwd minera

This isn't the web password, to change the web password, login into the web interface and go to Miner -> Settings

Miner binaries

The miner command binary path is:

minera-bin/[miner]

They are pre-compiled for Raspberry (ARM) with the latest version available.

To ensure you have every libraries installed I strongly recommend you to recompile the miner you need, Minera has a utility script to do this, please look below.

Build miners

Please follow the commands below to recompile/build your miner softwares (bfgminer, cpuminer, cgminer, cgminer-dmaxl):

cd /var/www/minera
./build_miner.sh [miner-name | or empty for usage]

Ready

Now you are ready to mine with your brand new Minera controller.