msOS doesn't boot

If msOS doesn't boot after 2 minutes of waiting, then there was something wrong with the initial process.

Basic check-ups

It is good to do the following:

  • Check config.js and make sure that both access key and worker name are written correctly (they are case sensitive).
  • If you used some other mining OS on this same rig, try to plug the USB to another port. Sometimes rig will cache old settings that prevent msOS to boot correctly and putting the USB to other USB port fixes this.
  • Make sure you have access to the internet.
  • Check if you have used correct msOS version regarding the cards you are using (you can find the versions on the msOS page).


If all of these things are good and OK, we suggest to also do the following:

  • Enable Legacy USB / CSM
  • Disable Internal Graphics
  • Set PCI Link Speed GEN2


If you are using msOS v1.1, you have to enable Legacy USB / CSM in your BIOS.

If you are using any other msOS version and getting initramfs error, this indicates a bad flash. We suggest to do the following:

  • Flash msOS image to another USB or SSD. You can restore the USB to initial state with this tutorial.
  • Change USB port.


If you still couldn't get msOS to boot, contact us and our tech team will help you out. You can find us on live chat on the minerstat dashboard or on our Discord channel.