home · knowledge base · pool · blog · changelog · source · statistics · support · sampleconf · ConfigMaker · buy ethOS · mining calculator
Table of Contents
Getting Support
Quick Start Guide
Video Guides
Mining Zcash
Mining Monero
Adding claymore 9.2 to ethOS
Adding claymore-zcash 12.4 to ethOS
Adding optiminer-zcash 1.7.0 to ethOS
Updating ethOS to the Latest Version
Writing ethOS to SSD on Windows
Writing ethOS to SSD on Linux (debian/ubuntu flavors)
Booting a Rig without a Power Button
Initial Setup (using a Keyboard and Monitor on ethOS)
Booting into ethOS
Provisioning AMD boards
Provisioning Intel boards
Fixing 290/390/470/480 boot problems with Intel boards
Fixing ADL Error / Hardware Error
Using SSH to Login to ethOS from Windows
Forcing ethOS to keep local.conf changes after Reboots
Setting and Switching your Wallet and/or Pool
Changing your Worker Name
Using a Pool that Requires Workers, Usernames, and Passwords (suprnova)
Setting up your own Remote Config
Using ConfigMaker.com for your Remote Config
Setting up a DigitalOcean Droplet for your Remote Server
Setting a Static Internal IP for your ethOS Rig
Overclocking
Managing Temperature
Setting a custom Panel ID
Fixing Unexpected low Pool Hashrate
Autotrading Altcoins for Bitcoin
Mining and Common Issues

Getting Support

There is no email or skype support for ethOS.

If you need help with ethOS, talk to us in IRC (#ethosdistro on Freenode).

Generating a Diagnostics File before joining #ethosdistro IRC Support
  1. Wait for your rig to enter its crashed, broken, or non-working state.
  2. Run gethelp in a terminal while connected to your rig, and copy/save the output link.
  3. Connect to IRC with the below guides.
  4. Once connected, paste the gethelp link in channel, describe the issue in your own words, include recent changes and any troubleshooting steps that you have done.
  5. Wait for a reply and talk in channel.
Joining #ethosdistro IRC Support from your Web Browser
  1. On your regular PC or computer, visit https://webchat.freenode.net/?channels=ethosdistro.
  2. Enter a nickname for yourself.
  3. Do not change the "channels" field.
  4. Do not checkmark "auth to services".
  5. Checkmark "i'm not a robot".
  6. Click connect and wait up to 15 seconds to connect to the IRC channel.
Joining #ethosdistro IRC Support using your IRC Client

Channel: #ethosdistro
Server: irc.freenode.net
Port: 6667

Joining #ethosdistro IRC Support from your local rig
  1. Run ethoschat-local in your ethOS terminal.
  2. Wait up to 15 seconds for your rig to join the IRC channel.
  3. ALT+TAB between the regular Terminal and the ethoschat Terminal.
  4. To quit ethoschat, run /exit inside of the ethoschat Terminal and ALT+TAB to the regular Terminal.
Joining #ethosdistro IRC Support from your remote rig via SSH
  1. Run ethoschat in your SSH session.
  2. Wait up to 15 seconds for your rig to join the IRC channel.
  3. To quit ethoschat, run /exit inside of your SSH session.

Quick Start Guide

  1. Run helpme to get a list of commands, your stats panel link, and rig status.
  2. Force ethOS to keep local.conf changes after Reboots.
  3. In /home/ethos/local.conf , change "0x0bdC4F12fB57d3acA9C3cF72B7AA2789A20d27f2" to your wallet.
  4. Change user "ethos" password with passwd ethos to secure your rig.
  5. Reboot with r.

NOTE: ethOS is set to mine to the ethOS Ethereum pool. Check your mining statistics at http://ethosdistro.com/pool/


Video Guides


Mining Zcash

  1. Update ethOS.
  2. Get started with the Quick Start Guide.
  3. Set globalminer claymore-zcash or miner [worker] claymore-zcash in config.
  4. Set proxywallet to your zcash wallet.
  5. Set proxypool1to your zcash pool (example pools: flypool and nanopool).
  6. Optional: Set -i flag to set intensity: flags -i 3 OR flg [worker] -i 3
  7. If you experience crashing, revert to all stock clocks, check again, then revert to stock bios (flip GPU bios switch).

Mining Monero

  1. Update ethOS.
  2. Get started with the Quick Start Guide.
  3. Set globalminer sgminer-gm-xmr or miner [worker] sgminer-gm-xmr in config.
  4. Set proxywallet to your Monero wallet. NOTE: If mining to exchange, you need proxywallet wallet.paymentid
  5. Set proxypool1 and proxypool2 to your Monero pools (both pools must be defined).
  6. If you have 2GB GPUs, set rawintensity to a lower value in /home/ethos/sgminer-gm-xmr.stub.conf
  7. If you experience crashing, revert to all stock clocks, check again, then revert to stock bios (flip GPU bios switch).
  8. If miner fails, remove both .WORKER from /home/ethos/sgminer-gm-xmr.stub.conf (some pools do not accept worker well).

Adding claymore 9.2 to ethOS

  1. Update ethOS.
  2. Make sure your GPUs are not in a crashed state. It is best to proceed immediately after a reboot.
  3. Set globalminer claymore or miner [worker] claymore in config.
  4. Run: sudo update-miner claymore && sudo service ethos-miner-monitor restart
  5. See the Claymore Bitcointalk thread for configurations options that can be set in /home/ethos/claymore.stub.conf

NOTE: If you have many rigs, use the above as a guideline for your own distribution method.
If any problem occurs and you would like to revert, run: ethos-update reupdate


Adding claymore-zcash 12.4 to ethOS

  1. Update ethOS.
  2. Make sure your GPUs are not in a crashed state. It is best to proceed immediately after a reboot.
  3. Set globalminer claymore-zcash or miner [worker] claymore-zcash in config.
  4. Run: sudo update-miner claymore-zcash && sudo service ethos-miner-monitor restart
  5. See the Claymore Zcash Bitcointalk thread for configurations options that can be set in /home/ethos/claymore-zcash.stub.conf

NOTE: If you have many rigs, use the above as a guideline for your own distribution method.
If any problem occurs and you would like to revert, run: ethos-update reupdate


Adding optiminer-zcash 1.7.0 to ethOS

  1. Update ethOS.

Updating ethOS to the Latest Version

  1. Read the changelog for very important major changes.
  2. Become physicaly local to your rigs. Do not update remotely.
  3. Prior to updating, reboot your rig (a fresh rig is important for a successful update).
  4. Immediately after your rig boots successfully, run the update: sudo ethos-update && sleep 5 && r   (do not interrupt it)
  5. After your rig updates, it will reboot. Watch your rig come up.
  6. If your rig fails immediately after updating and rebooting, reupdate your rig: sudo ethos-update reupdate && sleep 5 && r
  7. If reupdate fails, reimage your SSD. Reply to any gpuShack email if you bought ethOS and have trouble downloading it.

Writing ethOS to SSD on Windows

NOTE: ethOS should only be written to a 16gb+ SSD (not an HDD).

  1. Download and unzip the downloaded file with 7-zip, it will extract into approximately a 7.5gb image.
  2. Use Raw Copy Tool (available at http://hddguru.com/software/HDD-Raw-Copy-Tool/ ).
  3. Plug in the destination SSD to the sata power cable first, then to the sata data cable. Raw Copy Tool will recognize the drive and allow you to clone the ethOS iso onto the drive, sector for sector.

Writing ethOS to SSD on Linux (debian/ubuntu flavors)

NOTE: ethOS should only be written to a 16gb+ SSD (not an HDD).

  1. Download and uncompress the downloaded file with unxz /path/to/ethos.xz, it will extract into approximately a 7.5gb image.
  2. Confirm the location of your source ethOS iso file:
    ls /path/to/ethos.iso
  3. Physically attach your destination SSD to the sata power cable first, then to the sata data cable.
  4. Confirm that your rig sees your destination drive. You should see the destination drive appear as /dev/sdX where X is your enumerated drive (i.e. /dev/sdb):
    dmesg | grep sd
    fdisk -l | grep sd
  5. Confirm that your destination drive is correct with smartctl:
    apt-get -fy install smartmontools
    smartctl -i /dev/sdX (replace X with your enumeration)
  6. Clone your source to your destination. VERY IMPORTANT, if you make a mistake and accidentally clone to a different drive, you will cause CATASTROPHIC DATA LOSS.
    apt-get -fy install gddrescue
    ddrescue --force -r2 /path/to/ethos.iso /dev/sdX (replace X with your enumeration)
  7. Watch the progress. ddrescue should finish with no errors after it clones 16gb worth of data. After it is done, it is safe to shutdown and power off your rig. The ethOS drive is now ready for use.

Booting a Rig without a Power Button

Rigs do not need a power button. After this guide, you can use the I/O switch on the PSU to power the rig on and off.

  1. Build your rig as if you were building a bench-test computer. Use the motherboard manual if necessary, and connect all components.
  2. Make sure your PSU is plugged in, and that the PSU switch is set to the ON position.
  3. Boot your motherboard by shorting the power pins with a small metal tool (screwdriver).
  4. Upon boot, go into the motherboard bios and set BOOT ON POWER to ENABLE or AC BACK ON (consult your manual).
  5. Save your settings, and exit.

Initial Setup (using a Keyboard and Monitor on ethOS)

During initial setup, you can connect a keyboard and monitor to your rig to watch it boot up.

  1. Without using a riser, attach a GPU to the gpu0 PCI-E slot on your motherboard. (ignore all 1x slots, the gpu0 PCI-E slot in always the 16x PCI-E slot that is physically closest to your motherboard's CPU socket).
  2. Attach a monitor to the left-most DVI port of gpu0. If you incorrectly connect your monitor to another GPU or to onboard video, you will get a blank display.
  3. If your rig POSTs, you will see a GPU detection screen during bootup. If your rig does not POST, power off. Check to make sure the CPU, CPU cable, and 24-pin ATX cable are seated properly. Then, test each stick of RAM individually in each RAM slot.
  4. ethOS will boot to the desktop automatically. After your rig boots successfully, all interaction with ethOS is done via the terminal screen.

If fewer GPUs show up here than are connected to your rig, check all connections and reboot, If some GPUs are still missing, it is a hardware, riser, or motherboard bios problem, not a software problem. No linux command will fix this.


Booting into ethOS

  1. Plug the ethOS SSD into a SATA power and a SATA data cable.
  2. Boot the rig.
  3. The rig will boot to the ethOS desktop, and the fans will ramp up. The fan ramp-up is normal and is not indicative of a crash.

If your rig fails to boot due to "initramfs" error, EFI Shell, or boots directly to BIOS, proceed with the below guide:

  1. Power off your rig.
  2. Try a few different SATA ports on your motherboard, some may be disabled in BIOS.
  3. Try a different SATA power connection, it may not be seated properly.
  4. Try a different SATA data cable, it may be faulty.
  5. Reclone the SSD from the ethOS download link to your current drive, or a spare drive.

If your rig fails to boot due to "Kernel Panic", reseat and test all RAM. Make sure that your rig detects at least 4gb of RAM. If the issue persists, continue with the below guides:


Provisioning AMD boards

If you have an AMD board and have network connectivity issues or are unable to successfully boot with multiple GPUs, follow the below guide:

  1. If you have many GPUs, make sure that no GPU is plugged in directly to any 16x slot. Risers must be used for all GPUs.
  2. Unplug all GPUs except for gpu0 (ignore all 1x slots, gpu0 is always the 16x PCI-E slot physically closest to your motherboard's CPU socket).
  3. If your motherboard has molex or PCI-E onboard power jacks, make sure to plug the correct cable into them.
  4. Follow the guide for Using a keyboard and monitor on ethOS.
  5. Upon boot, go into the motherboard bios and set the following options (set as many of these options as you can find):
    • set IOMMU to ENABLE.
    • set VIRTUALIZATION (C1E) to DISABLE.
    • set POWER CONTROL (SVM) to DISABLE.
    • set CPU UNLOCK to ENABLE (this may prevent CPU temp from being read properly).
    • set COOL AND QUIET to DISABLE.
    • set CPU CORE CONTROL equal to the amount of CORES PER PROCESSOR for your particular CPU make/model.
    • set ONBOARD AUDIO/SOUND (AZALIA) to DISABLE.
    • set IEEE1394 to DISABLE.
    • set APU ONBOARD GRAPHICS to DISABLE.
  6. Save changes and reboot.
  7. Allow rig to boot completely with just one GPU, then update ethOS.
  8. After update, reboot, connect the rest of the GPUs.

Provisioning Intel boards

If you have an Intel board and have network connectivity issues or are unable to successfully boot with multiple GPUs, follow the below guide:

  1. If you have many GPUs, make sure that no GPU is plugged in directly to any 16x slot. Risers must be used for all GPUs.
  2. Unplug all GPUs except for gpu0 (ignore all 1x slots, gpu0 is always the 16x PCI-E slot physically closest to your motherboard's CPU socket).
  3. If your motherboard has molex or PCI-E onboard power jacks, make sure to plug the correct cable into them.
  4. Follow the guide for Using a keyboard and monitor on ethOS.
  5. Upon boot, go into the motherboard bios and set the following options (set as many of these options as you can find):
    • set VTd INTEL VIRTUALIZATION to DISABLE.
    • set ONBOARD AUDIO/SOUND (AZALIA) to DISABLE.
    • set IEEE1394 to DISABLE.
    • set PCI-E SUBSYSTEM/LANES to x8/x4/x4
    • set ONBOARD GRAPHICS to DISABLE.
    • set PCI-E GENERATION to GEN2.
  6. Save changes and reboot.
  7. Allow rig to boot completely with just one GPU, then update ethOS.
  8. After update, reboot, connect the rest of the GPUs.

Fixing 290/390/470/480 boot problems with Intel Boards

If you are running this GPU on an Intel motherboard, you may experience boot problems in certain cases. Please see the guide below:

NOTE: If you use onboard video, POST will occur on onboard video, and the ethOS desktop will be displayed on gpu0.


Fixing ADL Error / Hardware Error

The following fatal errors will prevent mining if your GPU, RISER, or other HARDWARE experience a failure.

This hardware error cannot be fixed with software. Follow the procedure below to determine which hardware is causing the failure.

  1. Power off rig.
  2. Unplug half the GPUs from risers.
  3. Reseat the power and riser connections of the other half.
  4. Power rig back on.
  5. If the rig starts mining after step 4, proceed with step 6.
  6. Repeatedly add GPUs one by one until the rig experiences the above error again.
  7. If the rig does not start mining after step 4, then power off, unplug the other half, plug the other half back, and proceed with step 6.

Using SSH to Login to ethOS from Windows

  1. Connect your computer to the same network as your rigs.
  2. Download Putty from http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe.
    Putty is an executable that can be run without installing.
  3. Find the IP of your rig.
    You can find your rig's IP on your ethosdistro.com stats panel, on your rig's desktop, or on your router's DHCP client table.
  4. Open Putty and input Rig Information.
    Type the rig's IP into Host Name. Port should be 22. Click Open.
  5. Login to ethOS.
    When the terminal window shows up, login with username ethos, password live.
  6. Begin using Linux.
    Type helpme and press ENTER to get started.

Pasting Text: In Windows, CTRL+C to copy text. In putty, SHIFT+INSERT to paste it.

To SSH remotely:

  1. Change the root and ethos passwords. NOTE: Failure to change passwords will allow people to hack your ethOS (high rx/tx).
  2. Set up SSH portforwarding on your router using the below guides:

You can also set up a dedicated VPN box on your rigs' network, and connect to it using your favorite VPN software.


Forcing ethOS to keep local.conf changes after Reboots

ethOS comes pre-installed with a sample remote config.

It is highly recommended that you use your own remote config. However, if you don't want to use the remote config, you must turn it off.

ethOS will over-write the contents of /home/ethos/local.conf if remote config remains on.

How to turn off the remote config:

echo -n "" > /home/ethos/remote.conf && echo "remote config turned off"

Setting and Switching your Wallet and/or Pool

Note: If you have just one rig, set ethOS to single-rig mode before following this guide.

  1. Edit either your remotely hosted config file, or /home/ethos/local.conf (single-rig mode).
  2. Define your wallet and pools by replacing the default ones for proxywallet, proxypool1, proxypool2
  3. After you change the config, run putconf && minestop, the miner will stop, and then start up automatically with your new settings.
  4. Use show miner to watch the miner log.
  5. After your wallet is switched, in 5-10 minutes, your pool should show mining activity. You can copy and paste your wallet to the pool website interface in order to check for mining activity.

Changing your Worker Name

To switch your worker name and assign a rack location, follow the below guide.

  1. In your config, set loc [worker] newname ([worker] is your original 6-digit rigname and "newname" is your new rig name).
  2. Do not add a newname to your wallet like wallet.newname, this will not work.
  3. Do not use very long newname. The maximum length is 8 characters.
  4. Do not use the same newname for multiple rigs.
  5. Reboot your rig.

After this procedure, your pool will see your new worker name, and your rig will have a new rack location assigned on the ethosdistro.com panel.


Using a Pool that Requires Workers, Usernames, and Passwords (suprnova)

Some pools (suprnova) require usernames, passwords, and workers. Follow this guide for configuring ethOS to work on these pools:

  1. Find your worker name for each rig. ethOS assigns a 6-digit alphanumeric code (worker name) for each rig.
    You can find out your worker name by looking at the ethosdistro.com stats panel, rig desktop, or ssh terminal.
  2. Login to the pool website. On the pool website, add a worker for each ethOS rig/worker that you have, use password "x".
    Note: If you use the loc parameter in your config, your worker name will be the loc that you specified.
  3. In your config, set proxywallet username where username is your actual pool-side user name that you use to login.
  4. After you change the config, run putconf && minestop, the miner will stop, and then start up automatically with your new settings.

Setting up your own Remote Config

  1. Copy http://ethosdistro.com/pool.txt and host it yourself on a remote server, vps, or shared hosting account that you control.
  2. Get the link to your remote config like http://your-server.com/config.txt.
    NOTE: The link http://your-server.com/config.txt is an example. You must use your own link.
  3. Import your remote config: echo -n "http://your-server.com/config.txt" > /home/ethos/remote.conf
  4. Make changes to your remotely hosted config, and reboot your rig to have them take effect.

After you set up your remote config, you can manage all your rigs via your remote config file, even remotely reboot them. More detailed configuration documentation is available at http://ethosdistro.com/pool.txt


Using ConfigMaker.com for your Remote Config

  1. Copy your config from /home/ethos/local.conf or from http://ethosdistro.com/pool.txt to the Text Editor at ConfigMaker.com
  2. Edit the config to suit your preferences and press 'Save Changes'.
  3. Bookmark your private text editor.
  4. Import your remote config to your ethOS rig: echo -n "https://configmaker.com/my/VeryNiceCleanConfig.txt" > /home/ethos/remote.conf
    NOTE: The link https://configmaker.com/my/VeryNiceCleanConfig.txt is an example. You must use your own link.
  5. Make changes to your ConfigMaker.com config, and reboot your rig to have them take effect.

Setting up a DigitalOcean Droplet for your Remote Server

If you do not have a remote server, you can use DigitalOcean.

  1. Go to DigitalOcean (follow this link to get 2 months free), create an account, then click on "Create Droplet".
  2. Click on "One-Click Apps".
  3. Select "LAMP on 14.04", $5/mo, and the datacenter closest to your physical location.
  4. After the droplet is created, follow the SSH guide to SSH to your DigitalOcean droplet.
  5. Descend into the world-readable html directory with cd /var/www/html
  6. Copy the sample config to your DigitalOcean Droplet with wget http://ethosdistro.com/pool.txt
  7. Make changes to your remotely hosted config on your DigitalOcean droplet with nano /var/www/html/pool.txt
  8. The link to your remotely hosted config is now http://[your-digital-ocean-ip-address]/pool.txt
  9. To use your remote config, see: Setting up your own remote config.

Setting a Static Internal IP for your ethOS Rig

In some cases, you may want to assign a static IP to your ethOS rig. It is recommended to assign static IPs based on mac addresses on your router. However, you can also set a static IP on linux itself:

  1. Make changes to your interfaces using this as a guide.
    in /etc/network/interfaces change:
    auto eth0
    iface eth0 inet dhcp
    to:
    auto eth0
    iface eth0 inet static
       address 192.168.0.201
       netmask 255.255.255.0
       network 192.168.0.0
       gateway 192.168.0.1
       dns-nameservers 8.8.8.8
    
  2. Reboot your rig.

NOTE: Set the IP according to your correct IP range, outside of your DHCP range.


Overclocking

It is best to have your rig stable for 24 hours before attempting overclocks.

  1. Follow the instructions on http://ethosdistro.com/pool.txt to set overclocks globally, or for individual rigs.
  2. After you set overclocks, you can either reboot, and the rig will take the new config and apply the new clocks automatically, or you can run putconf && ethos-overclock, and your rig will apply the overclocks during the mining session.
  3. Use show miner to watch the miner log.

NOTE: If your rig crashes or hangs after setting overclocks, follow the below guide:

  1. Reduce all overclocks to stock settings and reboot.
  2. Monitor the rig for 24 hours to make sure it does not crash again.
  3. If required, set a less aggressive overclock and continue to monitor the rig.

Managing Temperature

Your rig's GPUs will throttle (powertune set to 0 and core clock set to 800 mhz) if your GPU temperature reaches 5 degrees lower than maxgputemp in the config.

If you rig's GPUs overheat or throttle, follow the below suggestions for a permanent fix.

To reset all temperature-related conditions, you can reboot your rig or run clear-thermals


Setting a Custom Panel ID

ethOS automatically assigns a 6-character panel ID based on a hash of your external IP address. This way, all rigs on one network can report to the same panel. If your public IP changes, your panel will change.

You can run helpme to get your current ethOS stats panel link.

You can set your own custom Panel ID with the custompanel parameter.

In your config, set custompanel publicsecret (exactly 12 characters) where public (exactly 6 characters) is your preferred panel ID, and secret (exactly 6 characters) is your private key. Then, reboot.

Example: custompanel myrigsrandom will make all your rigs report to http://myrigs.ethosdistro.com


Fixing Unexpected low Pool Hashrate

The pool-side reported hashrate should be completely ignored. The pool reports may report a hashrate of "0", or of just a single GPU. Please use the pool-side effective hashrate to see your true hashrate for the entire rig.

If, after mining for 24 hours, your pool effective hashrate is unexpectedly low, follow the below guide:

  1. Make sure that you are connecting to your pool via stratum.
    Do not use the pool config option if your node or pool is not on your local network, and make sure stratumproxy is enabled, and proxypool1 and proxypool2 are defined, as per the sample config located at http://ethosdistro.com/pool.txt.
  2. Ping your pool domain and make sure there is no packet loss (example: ping us1.ethermine.org)
    If there is packet loss, use another pool server that is closer to your geographic location.
  3. Reboot your rig.
  4. If you still get low hashrate, and if the router that your rig is connected to is also serving wifi, turn off the wifi feature and monitor the rig performance for another 24 hours.
  5. If the issue is resolved after disabling wifi, set up a dedicated router for your rig(s), and disable the wifi feature on the dedicated router.

Autotrading Altcoins for Bitcoin

You can autotrade your mined Altcoins directly to a Bitcoin Wallet.

  1. Go to https://shapeshift.io/
  2. Cick on the Deposit coin and select Ether (or any altcoin).
  3. Click on the Receive coin and select Bitcoin.
  4. Select Quick and click Continue.
  5. Input your Bitcoin Address and an Altcoin Refund Address (You can make an Ether Refund Address at myetherwallet.com)
  6. Checkmark I agree to terms and click Start Transaction.
  7. You will get a permanent receiving address. This address is controlled by Shapeshift, which will autotrade all deposits to Bitcoin, and send them to your Bitcoin Address.
  8. Set Shapeshift's receiving address in ethOS to mine directly to it and get Bitcoin in return.

Mining and Common Issues