How can I set up msOS?

Follow the next steps to set up msOS mining OS.

1. Prepare your rig for msOS

To install msOS on your mining rig you will need one USB 3.0 thumb drive with at least 16GB or SSD/HDD. Please follow the next guidelines to prepare your mining rig.

  1. Upgrade BIOS to the latest version;
  2. Disable onboard graphics;
  3. Enable UEFI/Legacy USB on your BIOS;
  4. Unplug all other hard disks;
  5. Prepare USB or SSD/HDD.

If you are using a Windows 8.1 system or older, please also read this article.

Note While USB 2.0 and 8GB USB are supported, we suggest you use USB 3.2 GEN2 of at least 16GB to ensure best experience.

2. Flash msOS to your USB or SSD/HDD

You can flash msOS on Windows, Linux terminal, or MacOS terminal.

2.1 Windows - Flashing msOS to USB or SSD/HDD

  1. Plug in prepared drive.
  2. Download and install Etcher.
  3. Open Etcher as Administrator.
  4. Select msOS zip file (msos-xx.zip).
  5. Select your USB.
  6. Click button Flash.
  7. When the process finishes, plug out the USB and plug it back in.
  8. When the system asks you if you want to format, click No or Cancel.
  9. Edit the config.js file and add your access key and worker's name or replace it with the config.js you downloaded from your minerstat dashboard.

In case there is no drive letter on freshly flashed HDD or SSD, follow the steps described here.

2.2 Linux terminal - Flashing msOS to USB or SSD/HDD

You can use Etcher instead of the terminal. The procedure is the same as for Windows.

When you follow the steps, replace xx with your msOS version - the number of the downloaded file.

  1. Plug in prepared USB 3.0 thumb drive or SSD/HDD.
  2. Open the terminal and write sudo -i and enter your password for root access.
  3. Write sudo apt-get install unzip in the terminal.
  4. Extract the downloaded archive with unzip /path/to/directory/msos-xx.zip -d /path/to/directory.
  5. Search your pendrive with fdisk -l (Search example for 16 GB USB: Disk /dev/sdX 15.XGB).
  6. Flash the prepared file sudo dd if=/path/to/directory/msos-xx.img of=/dev/sdX bs=1m
  7. Edit the config.js file and add your access key and worker's name or replace it with the config.js you downloaded from your minerstat dashboard.

2.3 macOS terminal - Flashing msOS to USB or SSD/HDD

You can use Etcher instead of the terminal. The procedure is the same as for Windows.

When you follow the steps, replace xx with your msOS version - the number of the downloaded file.

  1. Extract the downloaded archive with The Unarchiver.
  2. Open the terminal.
  3. Plug in prepared USB thumb drive or SSD/HDD.
  4. Search your pendrive with diskutil list.
  5. Flash the prepared file with sudo dd if=/path/to/msos-xx.img of=/dev/diskX bs=1m
  6. Edit the config.js file and add your access key and worker's name or replace it with the config.js you downloaded from your minerstat dashboard.

You can use Mounty to read-write NTFS partitions.

3. Configuration file

If you're unable to find config.js on the freshly flashed drive, you can use the methods in this article.

After flashing the msos-xx.img file to the drive you should edit the config.js file and add your access key and worker ID.

global.accesskey = "wTeR123459"​;
global.worker = "Rig1080Ti";

global.accesskey is your minerstat login access key.
global.worker is your worker's name.

You can edit config.js file with Notepad or any other text editor software.

How to change access key and worker's name from msOS?

In case you can't edit config.js on your computer, you can just boot the rig without updated config.js file and use one of the following options once the rig boots.

a) From console

To change your access key and worker's name from msOS, use command: mworker ACCESSKEY WORKERNAME and replace ACCESSKEY with you access key and WORKERNAME with your worker's name.

b) From GUI

If you are in the same local network as your rig, you can also use local msOS GUI to assign worker name and access key. Just open http://changeme.local and enter your access key and worker name and click [Connect].

minerstat - msOS GUI - Connect

4. Bulk flashing

For bulk flashing we suggest to use imageUSB software.

Revolutionize your mining operation with minerstat

It's easy and free to get started. Monitor, manage, and optimize your mining rigs with our powerful platform.

Sign up for free now