Miner Manager for ethOS
This OFFICIAL miner manager will install, update, or revert these unsupported miners to ethOS version 1.3.3
List of currently supported miners [click name to get miner specific information]
- [AMD] - cast-xmr - Hard Linked v1.7.1
- [AMD] - teamredminer - Latest
- [AMD] - xcash-amd - Custom Compiled v1 (miner only, run manually in /opt/miners/xcash-amd/)
- [AMD] - xmrig-amd - Latest
- [AMD] - wildrig-multi - Latest
- [NVIDIA] - cryptodredge - Latest
- [NVIDIA] - grin-miner - Custom Compiled v1.0.2 (AMD limited to a single GPU)
- [NVIDIA] - nbminer - Latest (miner only, run manually in /opt/miners/nbminer/)
- [NVIDIA] - nodecore-pow-cuda-miner - Latest (miner only, run manually in /opt/miners/nodecore-pow-cuda-miner/)
- [NVIDIA] - t-rex - Latest
- [NVIDIA] - zilminer - Latest (miner only, run manually in /opt/miners/zilminer/)
- [AMD,NVIDIA] - bminer - Hard Linked v15.3
- [AMD,NVIDIA] - energiminer - Custom Compiled v2.2.1
- [AMD,NVIDIA] - gminer - Latest
- [AMD,NVIDIA] - gringoldminer - Latest (miner only, run manually in /opt/miners/gringoldminer/)
- [AMD,NVIDIA] - grinpro - Hard Linked v1.2
- [AMD,NVIDIA] - lolminer - Latest
- [AMD,NVIDIA] - nodecore-pow-amd-cuda-miner - Custom Compiled v2.0a (miner only, run manually in /opt/miners/nodecore-pow-amd-cuda-miner/)
- [AMD,NVIDIA] - phoenixminer - Hard Linked v4.1c
- [AMD,NVIDIA] - ubqminer - Latest
- [AMD,NVIDIA] - xcash-all - Custom Compiled v1
- [AMD,NVIDIA] - xmr-stak - Custom Compiled v2.10.2 - hashrate reporting fix for multiple threads
- [AMD,CPU,NVIDIA] - soliditysha3miner - Latest
ONLY ONE ADDITIONAL MINER CAN BE INSTALLED AT A TIME
ethOS files are overwritten for the installation of each miner even though miners can be left in place with (update). Some miner dependencies will prevent other miners from starting you can completely uninstall a miner using the information here.
Following these instructions will install the chosen miner and its integration files on your ethOS machine. Each miner integration is stored in a branch of github for you to review.
You can get assistance through the support team here: http://ethosdistro.com/kb/#support
You need to be running ethos 1.3.3 to install a miner with this script.
Installing the miners
This script was designed for ease of use. You can run a single command to install, update, or remove any miner on this repo and any dependencies with it.
Below are instructions to install the miner-manager its-self if you think you will use it often, or you can skip installing the manager and just run the script from the github repo in which case the command would look like NON WORKING EXAMPLE
bash <(curl -s https://raw.githubusercontent.com/cynixx3/third-party-miner-installer-for-ethos/master/miner-manager) miner action
NOTICE: YOU SET THE LAST TWO WORDS to what you want to do. Where the miner is the name of the miner branch in this repo and the actions are install, update, or revert IE for a full install of phoenixminer example or an update of all files run:
bash <(curl -s https://raw.githubusercontent.com/cynixx3/third-party-miner-installer-for-ethos/master/miner-manager) phoenixminer install
The miner can be easily updated when new releases are out by just changing the action argument to "update" IE to only update the energiminer example program to the latest release run:
bash <(curl -s https://raw.githubusercontent.com/cynixx3/third-party-miner-installer-for-ethos/master/miner-manager) energiminer update
The miner can be easily uninstalled by changing the action argument to "revert" IE to uninstall wildrig-multi example run:
bash <(curl -s https://raw.githubusercontent.com/cynixx3/third-party-miner-installer-for-ethos/master/miner-manager) wildrig-multi revert
ethOS Config Sample
Here is an example of how to add ubqminer to ethos. These instructions will apply to any miner simply by changing "ubqminer" to the miner you want.
Set the miner
You can use the miner on your local config or globally on a remote config
OR in a remote config to set just one rig
miner c94e13 ubqminer
c94e13 is your EthOS rig hostname. You can get your miners hostname by running the terminal command
Set your pool and wallet
for local configs or remote configs to apply globally use
proxywallet walletORusername proxypool1 pool.com:port proxypool2 pool.com:port poolpass1 x poolpass2 x
OR to make it specific to this miner program in a remote config
ubqminer=proxywallet walletORusername ubqminer=proxypool1 pool.com:port ubqminer=proxypool2 pool.com:port ubqminer=poolpass1 x ubqminer=poolpass2 x
OR to make it specific to this rig
rigwallet c94e13 walletORusername rigpool1 c94e13 pool.com:port rigpool2 c94e13 pool.com:port rigpoolpass1 c94e13 x rigpoolpass2 c94e13 x
NOTES: Some miners allow you to use a single cpu thread, for these you can set
Some miners depend on a fallback pool, others do not use them. Best practice is to set both to avoid errors.
Manual config sample
ethOS requires several file changes in order to intergrate a miner into its config and hash reporting features, when this code has not been created you can manually run a miner. In this example we will use grinpro, but you can suppliment it with the miner of your choosing.
First stop ethOS from trying to manage a miner, run
disallow && minestop, then go to the miner folder
cd /opt/miners/grinpro and run the miner
./GrinProMiner to check that its working and to make any firt run configurations. This process will close when you disconnect from ssh and it will not start with ethOS. Exit the miner with the key combination
Once you get the miner to run and know the start command in order to mine add it to custom.sh nano guide
Add the following line with the information you discovered, above "exit 0" (you can also start the miner with this command)
screen -dmS miner /opt/miners/grinpro/GrinProMiner ignore-config=true stratum-address=eu-west-stratum.grinmint.com stratum-port=4416 stratum-tls=true email@example.com nvidia=0 amd=0:0 2>&1 /var/run/ethos/miner.output
2>&1 /var/run/ethos/miner.output allows you to use
show miner even in manual mode. Add any miner flags just as your pool or miner instructs. That's all you need to do.
Screen is a linux program that runs an interactive terminal session that you can run independently, connect, and disconnect from. To connect to the miner session and interact with it use
To disconnect from a screen session without killing the miner use the key combination
ctrl+a d where you press ctrl and a a the same time, release, then press d. Using the ctrl+c key combination will kill the miner, not the screen session and create an interesting situation where rebooting is the easiest fix (alternative is
ctrl+a k y, checking for live sessions with
screen -ls and killing them if found, then restarting the miner with the
screen -dmS ... command above.)
Installing the miner-manager (optional)
If you plan to use this often you can download the miner-manager script, give it execute permissions. To install simply copy paste the command:
sudo wget https://raw.githubusercontent.com/cynixx3/third-party-miner-installer-for-ethos/master/miner-manager -O /usr/bin/miner-manager sudo chmod +x /usr/bin/miner-manager
and use it with
miner-manager miner action To update the manager script just repeat the first command.
You are limited to installing 30 miners an hour as this script makes 2 API querries per install. With authenticated requests you get enough to install on 2,500 miners per hour per user.
See GitHub API Documentation for more information.
To authenticate, simply either use a file (/home/ethos/.gituser) or use the variables after installing the manager. These environmental variables are currently:
If you are a developer please check the developers guide for information on how to add your miner to ethos and / or this repo.
Any setting changes to the miner-manager (like an updated release) should be made to the miner.settings file in each miners branch of this repo.
If you got a new miner working using these tools or just improved an intergration please submit a pull request with a new branch for the miner you added.
- cYnIxX3 - Initial work - cYnIxX3 <== MVP
~ If you found this script useful please donate to encourage more development (every coin helps): ~ BTC bc1qk5mgs5tcm00287vapxupj5x4wqguhqr5qrmu8k ~ ETH 0x456ba7b1e9758c4c6fc56007107796f08ffba12b ~ XMR 44tLr5hm5g3LJnpy5HGK2hDADofwPXcPvCd1CF67q5NdavbiZuFKasWja1vCGpapDyfWXcqH49FWm6XkvJSfQ3Vh4TQ8oy3 ~ LTC LP7iuax4k57EC8GYo1inNMeqAVJ63mMrAc ~ Zcash Zcash t1YzbApi36dftoP2tchEzpZpDkLTM1XkNSq
- unsivil - added and integrated several miners - unsivilaudio
- Kahlid74 - added cryptodredge - Phaelon74
- virusHQ - ported ubqminer - virusHQ
- amnesium - ported grin-miner - amnesium
- asluchevskiy - ported t-rex - asluchevskiy
- Virosa - improved grin-miner, added bminer - Virosa
- HTCang - ported gminer - HTCang
This project is licensed under the MIT License - see the LICENSE.md file for details