seanwhe/xmrig-bash-scripts
1
1
Fork 0
mirror of https://github.com/seanwhe/xmrig-bash-scripts.git synced 2024-11-24 14:13:33 +03:00
Code Issues Packages Projects Releases Wiki Activity
Simple collection of bash shell scripts I use to manage xmrig cpu
51 Commits 5 Branches 1 Tag 109 KiB
Shell 100%
272b4f186d
Go to file
Sean Wheller 272b4f186d provide easy way to enable/disable user crontab
2019-08-08 20:40:41 +02:00
.gitignore fix git ignore 2019-07-30 22:37:34 +02:00
build.sh wip 2019-07-30 23:50:36 +02:00
config.sh handle cpu affinity 2019-08-01 22:22:11 +02:00
CONTRIBUTING.md Add contributing.md 2019-07-30 18:48:52 +02:00
CONTRIBUTORS Enhance script 2019-07-27 12:00:13 +02:00
crontab-off.sh provide easy way to enable/disable user crontab 2019-08-08 20:40:41 +02:00
crontab-on.sh provide easy way to enable/disable user crontab 2019-08-08 20:40:41 +02:00
crontab.sh Fix crontab 2019-08-05 21:49:49 +02:00
depends.sh minor fixes 2019-07-30 15:00:55 +02:00
functions.sh Fix crontab 2019-08-05 21:49:49 +02:00
install.sh Fix crontab 2019-08-05 21:49:49 +02:00
LICENSE Initial commit 2019-07-26 21:03:20 +02:00
maintenance.sh Enhance script 2019-07-27 12:00:13 +02:00
README.md add about updating 2019-07-30 19:03:10 +02:00
settings.sh Fix crontab 2019-08-05 21:49:49 +02:00
start.sh Fix crontab 2019-08-05 21:49:49 +02:00
stop.sh Add functions to load in stop 2019-07-30 15:03:02 +02:00

README.md

xmrig-bash-scripts

A set of convenience scripts, written in bash, to help manage installation, configuration and update of xmrig cpu across multiple hosts.

Download

Prerequisites

There is allot to install so the install script will do most of the heavy lifting. At the start the expectation is that you have:

  • Computer running Ubuntu 18.04 (LTS)
  • User account with sudo privileges
  • Installed git
  • Optionally installed xmrig-proxy

Agreeable

Some knowledge of:

  • Linux Command Line Interface
  • Unix shell bash

There is more to install but the install script will install the rest.

Installion

  1. Change to your user home directory. cd ~

  2. Install git. sudo apt install git

  3. Clone this project. git clone https://github.com/seanwhe/xmrig-bash-scripts

  4. Change into the cloned directory. cd xmrig-bash-scripts

  5. Edit the settings file to your preference. vim settings.sh

  6. Run the install script ./install.sh

  7. Attach to the screen session created during the installation. screen -r

Operation

With the exception of the 'xmrig' binary, which is installed to /usr/bin/xmrig, all files remain in the cloned project directory ~/xmrig-bash-scripts. Any files generated while running the scripts are created in this directory.

During install the folder source for xmrig cpu is cloned to xmrig-cpu/in the path. The config.json is also created in this path.

This should work out the box, if you edit only the top section of settings.sh.

Once you have a running xmrig then you can start playing around and tweaking to suite requirements.

What follows is a brief of the shell scripts you will find. The names are mostly self explanatory. Comments and notes are used liberally in the scripts to help give you hints as to how it works. The scripts are designed to be modular to promote resuse, execute exclusion and standalone execution.

  • build.sh - clones xmrig to ``~/xmrig-bash-scripts/xmrig-cpu, configures, builds and copies xmrig to /usr/bin/
  • config.sh - contains variables that aid in defining the values for the attributes found in config.json.
  • crontab.sh - installs a cron to start and a cron to stop at specific times (Can be commented out of install if desired).
  • depends.sh - installs dependancies required by xmrig and these scripts.
  • functions.sh - a collection of functions used in various of the scripts.
  • install.sh - the main entry point when first installing.
  • maintenance.sh - performs apt update and upgrade.
  • settings.sh - contains variables used by these scripts.
  • start.sh - starts xmrig in a screen session.
  • stop.sh - stops xmrig screen session.

Viewing the log

Default of the start script is to create a screen session named 'xmrig-cpu'. This can be changed in the settings script if required. To view the log after installation is finished or after running the start script, used the following command: screen -r xmrig-cpu

Updating

A simple git update in ~/xmrig-bash-scripts will update these scripts.

The install script can be run at any time to update the xmrig source found ~/xmrig-bash-scripts/xmrig-cpu. The branch checkout is taken from the _XMRIG_BRANCH variable in settings.sh.

Reporting issues

xmrig cpu and xmrig bash scripts are different projects run by different people.

While the developers of both projects may be seen interacting with one another on either project, we ask that you report issues to the respective projects. In other words, post issues for:

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

See also the list of contributors

Authors

  • Sean Wheller - Initial work - seanwhe

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE.md file for details

Acknowledgments