Mining Help


How to configure NiceHash OS?

Here is the list of preconditions that must be met before you can proceed:

  • Computer with one of the following operating system: Windows, macOS or Linux.
  • NiceHash OS flash drive.
  • A text editor you are familiar with.

Any text editor is fine as long as it does not modify the file format being edited. Depending on the operating system, you can use the native text editor (Notepad for Windows, TextEdit for macOS, Vi for Linux), or any of the 3rd party editors.


NICEHASH OS CONFIGURATION

NiceHash OS flash drive is divided into two partitions, SYSTEM and NHOS, where the NHOS partition contains the configuration data for the system to operate correctly.

When NiceHash OS flash drive is inserted into your computer, the system should automatically detect NHOS partition and show it in system file manager (Windows Explorer, macOS Finder, Linux Nautilus, etc.) as a disk on Windows or as a mounted device on macOS and Linux.

Using your file manager, navigate to the location of the NHOS disk or mount point. There you will find a single configuration file named configuration.txt.

To modify NiceHash OS configuration, open this configuration file with your preferred file editor where you will see the following file content structure:

NOTICE: From June 2022 onward, you should use your Mining Address and NOT your Bitcoin Wallet address.

{

"rig": {

"btc": "",

"worker": "",

"group": ""

},

   "access": {

"ssh": {

"key": "" }

},

   "network": {

       "wireless": {

"ssid": "",

"key": ""

}

}

}



The configuration is divided into different sections:

  • rig,
  • access,
  • network.

All the sections contain configuration entries which are named to be as self-explanatory as possible.

BTC address is the only mandatory information that needs to be present in the configuration and is part of the rig section, while access and network sections can be left empty or removed from the configuration file if not needed.

NOTICE: From June 2022 onward, you should use your Mining Address and NOT your Bitcoin Wallet address.

RIG

This section is used to configure the NiceHash OS mining feature.

  • btc - Your NiceHash Mining Address. [mandatory] - THIS IS NOT YOUR BITCOIN WALLET ADDRESS!
  • worker - Name of your mining machine (sometimes referred to as rig name). Have in mind, that the worker name is limited to alphanumeric characters from the English alphabet, a to z, A to Z, 0 to 9 and characters - (hyphen), _(underscore). [optional]
  • group - Put your mining machine into the group. [optional]


ACCESS

This section is used to configure SSH user for the remote network access to the mining machine. If you want to have remote network access to your mining machine, you must fill in this section, otherwise, leave it empty or remove it from the configuration file.

  • ssh - SSH public key for user authentication. [optional]

There is no special configuration for local shell user access. More information on how to access mining machine locally is available on NiceHash OS local access chapter.


NETWORK

This section is used to configure mining machine network settings. There is only a wireless configuration entry here, and if you are using wireless infrastructure, you must fill in this section, otherwise leave it empty or remove it from the configuration file.


  • ssid - SSID to provide the name for wireless network access. [optional]
  • key - Security key for wireless network access authentication. [optional]


For security reasons, only WPA and WPA2 security protocols are supported.

There are no configuration entries to configure wired network settings. Also, there are no configuration entries to define static IP address to be assigned to the mining machine. No matter if you are running the mining machine on a wired or wireless infrastructure, an IP address is always assigned dynamically using DHCP protocol.

Example of how configuration might look like after modification.

NOTICE: From June 2022 onward, you should use your Mining Address and NOT your Bitcoin Wallet address.

{

"rig": {

          "btc": "NH8xDN798uKMgPxTt35pgmGcdpJnSAvgsMF",

          "worker": "centaurus",

          "group": "constellation"

      },

      "access": {

          "ssh": {

              "key": "ssh-rsa

  AAAAB3NzaC1yc2EAAAADAQABAAABAQCoWwJIm9JNgWzPrsMAeYWdM4nAkCET4j1kONsGPE2GeKul/

4dTiq8X8aTKVdLLXOTQxBsOjb6J4umgVioTuorthjD0lYM3HDp55BnBgcnXXm7TfKzWKyCcbXvpOZA1pdzLKT

  o8bSBWjq4P2J0xPO6A6QHQvQs2LDPc5SyDMYrXOKrPLHfNxzxg9mvry49RtQJSzBICnBWDc28pNSCjvKbeHzE

  A85Quy4ctR7A7cHHeR0G3k/Xozdc8/

  eUptxhbW2M4t4uUg4Tnh4OQEPJKQ5j4zvkqRxrzMV1Kvxuarxbouwci569ulaOYDUQI0S8BB57d5IP3HRvsG4

  Ok8HosIxTJ"

} },

      "network": {

          "wireless": {

              "ssid": "zodiac",

              "key": "8!Lf@I5s3tpY"

          }

} }

When you are done with configuration modifications, save your changes and safely unplug NiceHash OS flash drive from your computer.



Mining