Skip to content
This repository has been archived by the owner on Nov 11, 2021. It is now read-only.

Getting started

Michele Marcucci edited this page Sep 20, 2017 · 4 revisions

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.

You can use this script to install everything you need, or use the manual step below:

curl -o- https://raw.githubusercontent.com/michelem09/minera/master/install_minera_ubuntu.sh | sudo bash

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

sudo apt-get install -y lighttpd php7.0-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 php7.0-cli php7.0-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.

Update

Minera is frequently updated with new code to fix bugs and add new features. The author recommends to have always the latest version available running on your system.

Automatic update

When a new version is available you will notice a red "info" icon on the top right corner (near the link "Help") of the web interface. Clicking it you will have a dropdown menu with the button to run the automatic update. Follow the steps and in about 3 minutes you will have your Minera completely updated.

Manual update

If you are in trouble with the automatic update or if you'd like to do the update manually just connect to your Minera via SSH (you can also use the web terminal window) and do:

cd /var/www/minera
sudo git fetch --all && sudo git reset --hard origin/master && sudo ./upgrade_minera.sh

This will run the git update (code) and the upgrade script needed in some circumstances.

You could want also to update only the code, for that just do this:

cd /var/www/minera
sudo git fetch --all && sudo git reset --hard origin/master