Firmware (LuxOS)
Getting Started

Getting Started

Review EULA and Documentation

Before getting started with install please read our End User License Agreement (https://luxor.tech/firmware/eula (opens in a new tab)). This document highlights important details on using our firmware including our liability and warranties.

Our documentation can be found here (https://docs.luxor.tech/firmware (opens in a new tab)).

Install LuxOS with Commander

Luxor Commander is a powerful tool built for miners compatible with Windows, Linux and MacOS operating systems. Commander allows you to effortlessly scan your network for Bitcoin ASICs, monitor machines, update settings and install LuxOS directly to NAND to miners with stock firmware.

You can download Luxor Commander from our Download Center (opens in a new tab).

Scanning Network

Luxor Commander allows you to scan your network to discover mining machines. Follow these steps to perform a network scan:

  1. Open Luxor Commander.
  2. Click the Configure Network button. This will open a model where you can input a single miner IP, an IP range or multiple IP ranges.
  3. To start the scan, click the Scan Network button.

Luxor Commander Network Scan

Acceptable IP formats include:

  • Single IP: 192.168.1.1
  • IP Range: 192.168.1.1-192.168.2.255
  • IP Range: 192.168.1.1/24

After the scan finishes you will see the list of miners that were discovered on your network. If you enable Auto-Sync Commander will pull additional information from the miners and update the list.

Luxor Commander Miners

IP ranges will be automatically sorted and de-duplicated. Additionally, you can add a Label / Description to your IP range for easier identification.

Install LuxOS

Luxor Commander allows you to install LuxOS directly to NAND on miners with stock firmware.

💡

During install, LuxOS will keep the current network and pool configuration of the miner.

  1. Select the machines you want to install. Leverage filters to select a specific group of miners. We suggest you start with a small group of miners first.
  2. Click the Install LuxOS button. A new screen will pop-up.
  3. Click Begin, review and accept the EULA and proceed with the installation.
  4. Click Start Install to initialize the installation process.

Luxor Commander Installing

After a few minutes you should see the install finish and your ASICs will boot into LuxOS. You're all done.

If you have any questions, please reach out to us on here (opens in a new tab).

Commander User Guide

Settings

Luxor Commander allows you to configure a number of settings. To access the settings, click the Settings button in the top right corner of the screen.

There's four main settings to configure:

  1. Connection Timeout: This is the amount of time Commander will wait for a response from a miner before timing out.
  2. Retries per IP: This is the amount of times Commander will attempt to retry a connection to a miner before giving up.
  3. Auto-Sync Interval: This is the time between each data refresh. Auto-sync will pull additional information from the miners and update the list. Auto-Sync can be disabled.
  4. Install Threads: This is the thread count Commander will use to install LuxOS to selected miners in parallel.

Filters

Luxor Commander allows you to filter miners based on every column shown in the main-screen data table. To access the filters, click the header of each column and a pop-up filter will let you select a single option, multiple options or search for a specific value.

Luxor Commander Filters

Once you select the filters you want, click Apply and the data table will be updated with the filtered results. If you want to remove the filters, click Clear and the data table will be reset to the original state.

Configuring LuxOS Miners

LuxOS Commander let's you perform batch operations on your LuxOS deployment. You can select a single miner or a group of miners and perform the following operations:

To update your fleet, follow the steps below:

  1. Select the machines you want to update. Leverage filters to select a specific group of miners.
  2. Click on Configure Miners and you'll see the configuration screen pop-up.
  3. Edit the settings you want to change and click Review.
  4. elect the Miners per Batch and Wait between Batches and click Apply.
  5. You'll see the progress of the update on the screen.

Luxor Commander Configure LuxOS

Updating LuxOS

We are constantly shipping updates to LuxOS with new features, improvements and addititional miner support. You can keep track of new releases through our LuxOS Changelog.

To update your fleet, follow the steps below:

  1. Select the machines you want to update. Leverage filters to select a specific group of miners.
  2. Click on Configure Miners and you'll see the configuration screen pop-up.
  3. Navigate to Firmware and click on Stable to update to the latest stable release.
  4. Click Review, select the Miners per Batch and Wait between Batches and click Apply.
  5. You'll see the progress of the update on the screen.

Luxor Commander Update LuxOS

Introduction to FirmwareMiner Compatibility