home · knowledge base · pool · blog · changelog · source · statistics · support · sampleconf · ConfigMaker · buy ethOS
Table of Contents
Getting Support
Quick Start Guide
Video Guides
Mining Zcash
Mining Monero
Updating ethOS to the Latest Version
Updating Miners to Latest Versions
Writing ethOS to an 8gb+ USB 3.0 / HDD / SSD on Windows
Writing ethOS to an 8gb+ USB 3.0 / HDD / SSD on Linux (debian/ubuntu flavors)
Writing ethOS to an 8gb+ USB 3.0 / HDD / SSD or SSD on OS X
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
Properly distributing riser power to avoid instability
Fixing Kernel Panic with 5+ GPUs on Intel Z170/X/270/X/H110
Fixing 290/390/470/480 boot problems with Intel boards
Fixing ADL Error / Hardware Error
Robust Troubleshooting Guide for Motherboards and other Rig Components
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
Using TeamVIewer in ethOS

Getting Support

There is no email or phone 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. Connect to IRC with the below guides.
  3. Run gethelp in a terminal while connected to your rig, and copy/save the output link.
  4. Paste the gethelp link in the support 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 both user "ethos" and superuser "root" password with passwd ethos and sudo passwd to secure your rig.
  5. Reboot with r.
  6. NOTE: If you would like to reset all configs to their factory defaults, use reset-config.

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).

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)
    NOTE: slow USB 2.0 drives may have trouble updating.
  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 to your supported Drive.
    NOTE: For login download credentials, search your email for "gpushack". Your username/pass are in the email purchase confirmation.
  8. Reply to any gpuShack email if you bought ethOS and have trouble downloading it.

Updating Miners to Latest Versions

  1. Update ethOS.
  2. Make sure your GPUs are not in a crashed state. It is best to proceed immediately after a reboot.
  3. Run: sudo update-miners && sudo service ethos-miner-monitor restart
  4. Search Google for your miner version to get configuration options that can be set in /home/ethos/*.stub.conf files

You can check your current miner versions with cat /var/run/ethos/miner.versions

The following miners are currently available to update:

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


Writing ethOS to an 8gb+ USB 3.0 / HDD / SSD on Windows

  1. Download the ethOS file (the ethOS file is an archive that ends in .xz).
  2. Extract the downloaded archive with 7-zip, it will extract into approximately a 7.5gb image.
    NOTE: Do not use the native Windows unzip utility. If you use it, the downloaded archive will not extract properly, and will be corrupted.
  3. Do not mount the file. Use Raw Copy Tool (available at http://hddguru.com/software/HDD-Raw-Copy-Tool/ ).
  4. Plug in your USB or SSD Drive. If using an SSD, plug in the destination SSD to the sata power cable first, then to the sata data cable. Do not use a USB 2.0 drive, it is too slow.
  5. Raw Copy Tool will recognize the drive and allow you to clone the ethOS iso onto the drive, sector for sector.

Writing ethOS to an 8gb+ USB 3.0 / HDD / SSD on Linux (debian/ubuntu flavors)

  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. Plug in your USB or SSD Drive. If using an SSD, plug in the destination SSD to the sata power cable first, then to the sata data cable. Do not use a USB 2.0 drive, it is too slow.
  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 is done, it is safe to shutdown and power off your rig. The ethOS drive is now ready for use.

Writing ethOS to an 8gb+ USB 3.0 / HDD / SSD or SSD on OS X

  1. Plug in your destination USB Drive. If using an SSD Drive, use a USB to SATA adapter. Do not use a USB 2.0 drive, it is too slow.
  2. Open "Disk Utility" (Spotlight -> search for "Disk Utility") and select your external Drive from the left sidebar, then click "Info" at the top.
  3. Note the device IDENTIFIER of the destination drive (it could be something like disk2 or disk3, it may vary).
    IMPORTANT: Selecting the wrong IDENTIFIER will cause catastrophic data loss.
  4. Select your destination drive and click "Unmount" at the top.
  5. Download ethOS (.xz file)
  6. Open Terminal (Spotlight -> search for Terminal)
  7. Type gunzip (note the space), then drag/drop the downloaded .xz file next to the space after gunzip
    NOTE: Full command looks like gunzip /Users/YOURUSERNAME/Desktop/ethos-*.xz
  8. Press the Enter key and wait for the extraction to complete.
  9. Type sudo dd if= (no space after =), then drag/drop the extracted .iso file after sudo dd if=, then finish typing of=/dev/rIDENTIFIER bs=1m
    NOTE: Full command looks like sudo dd if=/Users/YOURUSERNAME/Desktop/ethos-*.iso of=/dev/rIDENTIFIER bs=1m (note the r)
  10. Press the Enter key and wait for the disk imaging process to complete.
  11. When the process completes, you might get message alert saying that the drive is not readable. Eject the drive at this point.
  12. 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. Plug in the RAM to the RAM slot(s) that are furthest away from the motherboard CPU socket (to avoid dual-channel RAM power cycling).
  4. Boot your motherboard by shorting the power pins with a small metal tool (screwdriver).
  5. Upon boot, go into the motherboard bios and set BOOT ON POWER to ENABLE or AC BACK ON (consult your manual).
  6. 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 your PSU 6/6+2 PCI-E power cable pins to the GPU PCI-E power cable jacks (located on the back of the GPU).
  3. 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.
  4. 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.
  5. 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. Remove all non-ethOS drives from your rig.
  2. Plug the ethOS drive to your rig. If using an SSD, plug in the SSD to the sata power cable first, then to the sata data cable.
  3. Boot the rig.
  4. 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.

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

For USB Drives

  1. Power off your rig.
  2. Plug in your USB drive into one of the USB ports in the same IO panel/hub as the Ethernet Port, or into any USB 2.0 Port.
  3. If ethOS does not boot and shows efi_main() failed, change motherboard BIOS boot order from:
    UEFI: usb : (NAME OF DRIVE) to USB: (NAME OF DRIVE), i.e. change from USBU to USB.

For SSD Drives

  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.

If the issue is not resolved, reimage the drive 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 Initial Setup.
  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 Initial Setup.
  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.

Properly distributing riser power to avoid instability

GPUs use a lot of power, and risers must have power balanced properly. Rigs will crash and may never start mining if they are not balanced.


Fixing Kernel Panic with 5+ GPUs on Intel Z170/x/270/x/H110

Follow the below guide if you have an Intel Z170/X/270/X/H110 motherboard and you experience problems booting with 5+ GPUs.

  1. Unplug all GPUs except one, and boot.
  2. If and only if you have an ethOS version under 1.2.2:
  3. Once you are on the latest version of ethOS, run lga1151-flasher. After it says Successfully Installed Bios, power off your rig.
  4. Plug in all GPUs and boot into ethOS.

For Unsupported Motherboards

  1. If the script returns No Bios Found, the ethOS support team will be notified automatically.
  2. Wait up to 24 hours for ethOS support team to add support for your Motherboard.
  3. Try to run lga1151-flasher again to resolve the issue.

If you have a motherboard that is not supported by lga1151-flasher, you can also update your motherboard BIOS version to the latest manufacturer firmware manually, yourself.

Common BIOS Options for fixing Kernel Panic with 5+ GPUs

MSI Motherboards
For ALL GPUs
For RX Series GPUs (in addition to ALL GPUs section)
For HD and R9 Series GPUs (in addition to ALL GPUs section)
ASUS Motherboards
ASROCK Motherboards

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.

Robust Troubleshooting Guide for Motherboards and other Rig Components

Example: You suspect that your motherboard is faulty.

Follow the below robust troubleshooting procedure step-by-step and do not skip any steps. Failure to follow this guide when asked by ethOS or gpuShack staff (as part of RMA procedure) will result in a voided warranty, as described in the gpuShack Warranty Agreement.

This robust troubleshooting procedure is useful because it isolates the issue to your suspect component. Otherwise, the issue could be a power balance issue, riser problem, loose cabling, bad power socket, bad PSU, etc.

Remove the motherboard from power and disconnect it from your rig. Then, remove the CMOS battery for 10 minutes. After that, plug the CMOS battery back in and follow these guides: Booting a Rig without a Power Button and Initial Setup. If the issue is unresolved, proceed with the below guides:

IF YOU SUSPECT THAT YOUR MOTHERBOARD IS FAULTY, DO NOT SWAP IN OTHER COMPONENTS INTO THE NON-WORKING RIG IN THE HOPES THAT IT WILL WORK, SWAP YOUR MOTHERBOARD INTO ANOTHER WORKING RIG!

  1. Find a working rig.
  2. Power off the working rig.
  3. Remove the suspect/"faulty" motherboard from your suspect/"faulty" rig.
  4. Remove only the working motherboard from your working rig, and keep the rest of the components there.
  5. Swap in the suspect/"faulty" motherboard into the working rig, where the previous working motherboard used to be.
  6. Test the working rig and suspect motherboard by following these guides: Booting a Rig without a Power Button and Initial Setup.

If the issue is resolved, then the issue is not with the motherboard. You can do this process for any component that you suspect is faulty.


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.


Force 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. If you don't want to use the remote config feature, you can turn it off with force-local

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

You can also blank out /home/ethos/remote.conf to turn off the remote config feature.


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

If your GPUs reach near the maxgputemp, all fans will set to 100%, and all GPUs will attempt to go into a lower power state.

If your GPUs exceed maxgputemp, all mining programs will shut down.

Follow the below steps to reduce the chances of your GPUs overheating:

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.


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


Using TeamViewer with ethOS

  1. Update ethOS.
  2. Boot into ethOS locally, with a monitor attached.
  3. Run the teamviewer command in the terminal.
  4. Read and accept the EULA; when the Welcome Wagon appears, click "Close".
  5. In the TeamViewer window, click "Connection" -> "Setup Unattended Access".
  6. In the Unattended Access wizard, click "Next".
    1. Do not change the computer name, and set your password (this will be your remote access password).
    2. Select "I don't want to create a TeamViewer account now", then click "Next".
  7. Click "Finish" to complete the wizard, and save your Connection Id Number.
  8. Download and install "TeamViewer for Remote Control" for your PC, Tablet, or Phone, and start the application there.
  9. Enter the TeamViewer ID Number that you saved earlier, then press "Remote Control".
  10. Enter the password that you set earlier, and press "OK".

Note: To disable TeamViewer, run rm /home/ethos/.config/teamviewer/client.conf

.