Ubuntu 16.04 unattended install for 6x RX580 Ethereum mining rig (AKA bula)
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Find precise hardware specs and BIOS settings on the bula 6x RX580 Ethereum mining rig.

bula is currently mining on 2Miners.

The software

For rig builders with different hardware specs, check the post-install.sh file. This will show you the steps required to install the following critical Ethereum mining software on Ubuntu Server 16.04.2:

  • Linux kernel v4.10
  • AMDGPU-PRO 17.40
  • ethereum via apt
  • ethminer from source

post-install.sh really is the heart of this repository. The steps therein get the software up and running. If you wish to make a fully unattended installer, continue reading.

Unattended installation

Though this is still a work in progress, it is a major step forward in locking down and fully automating installation of the software required to mine Ethereum out of the box. Once configured, mining is as easy as typing:


Make Ubuntu 16.04 image

The following steps were executed on an Ubuntu 16.04 installation.

Much of the following is adapted from: dsgnr/Ubuntu-16.04-Unattended-Install.

All that aside, you need a bootable USB!

This program will enable us to do just that:

sudo apt install xorriso

Create a directory in which to do your work:

mkdir myInstaller && cd myInstaller

Download the desired Ubuntu 16.04 image:

wget http://old-releases.ubuntu.com/releases/16.04.2/ubuntu-16.04.2-server-amd64.iso

This is an unattended install, so we need to set installation parameters. Use xorriso to extract the files from the ISO:

xorriso -osirrox on -indev ubuntu-16.04.2-server-amd64.iso -extract / custom-iso

Now open the grub.cfg file with your favourite editor (mine is vim!):

cd custom-iso && vim boot/grub/grub.cfg

Paste the following and save:

if loadfont /boot/grub/font.pf2 ; then
  set gfxmode=auto
  insmod efi_gop
  insmod efi_uga
  insmod gfxterm
  terminal_output gfxterm
set default=0
set timeout=1
set menu_color_normal=white/black
set menu_color_highlight=black/light-gray

menuentry "Mine Ethereum with the Mining King" {
  set gfxpayload=keep
  linux /install/vmlinuz gfxpayload=800x600x16,800x600 hostname=ubuntu16-04 --- auto=true url=https://raw.githubusercontent.com/TheMiningKing/ethereum-miner-bula/master/preseed.cfg quiet
  initrd  /install/initrd.gz

Note the URL location of the preseed file! It's currently linked to this repository, though there's nothing to say you can't serve up your configuration file from any server you choose.

You might do this, for example (optional):

git clone https://github.com/TheMiningKing/ethereum-miner-bula.git
cd ethereum-miner-bula
python -m SimpleHTTPServer

This will serve up the all the files required of the unattended installer.

Let's make this sucker bootable (again, all credit to dsgnr. This is all just sorcery...

Obtain isohdpfx.bin for hybrid ISO:

cd ../
sudo dd if=ubuntu-16.04.2-server-amd64.iso bs=512 count=1 of=custom-iso/isolinux/isohdpfx.bin

Create new ISO:

cd custom-iso
sudo xorriso -as mkisofs -isohybrid-mbr isolinux/isohdpfx.bin -c isolinux/boot.cat -b isolinux/isolinux.bin -no-emul-boot -boot-load-size 4 -boot-info-table -eltorito-alt-boot -e boot/grub/efi.img -no-emul-boot -isohybrid-gpt-basdat -o ../custom-ubuntu-http.iso .

Confirm partitions:

cd .. # or `cd ~/myInstaller`
fdisk -l custom-ubuntu-http.iso

Plug, unplug USB key to determine mount point using:

sudo fdisk -l

Write to USB drive:

umount /dev/sde
sudo dd if=/home/daniel/test/myInstaller/custom-ubuntu-http.iso of=/dev/sde

At this point, you should have a working, bootable installation CD. I usually only attach one GPU to the motherboard until installation is complete. After that, attach them one at a time (between reboots) to ensure all are working properly.


Your username is miner and your password is secret. Assuming all went well, your rig is rigged to run somewhere on your local network`.


ssh miner@


Grrrrrrr! I attempt to compile ethminer from source in post-install.sh. At the time of writing, this doesn't work yet. The process is not fully automated. It can be fixed, with the following Ethminer installation instructions:

Ethminer installation

The ethminer build doesn't work in post-install.sh for some reason. Execute this one time after initial system setup:

sudo ./ethminer-install.sh

Pull requests welcome...


At this point, you could simply type:

cd ~

and your rig would start submitting shares on behalf of my wallet. You probably want the shares to be credited to your wallet (though feel free to kick some change my way).

As it stands, everything is set up to join 2Miners and start mining. Relevant configuration files include:

  • ~/go.sh
  • ~/2miners-start.sh
  • ~/geth-start.sh


Start the Ethereum node. This isn't absolutely necessary, though I find an improvement in my hashrate when it is running.


Make sure you change your wallet address otherwise you'll be mining for me.


This just runs all the required scripts:


Take a peak inside and you'll see calls to ./geth-start.sh and ./2miners-start.sh.


If Dwarfpool is more your style, these are scripts of which you need to be aware:

  • ~/dwarfpool-start.sh
  • ~/eth-pool/eth-proxy.conf


As above, make sure you change your wallet address.


Not sure if this is absolutely necessary for stratum mining on Dwarfpool, but eth-pool is their recommended stratum mining proxy. The file itself is well documented. I'll leave it to you to set your wallet address, etc.


Yes please! This is meant to be helpful. Adapt it as you will.

If you can improve it, or have devised your own installation, let's hear all about it.