Luxor Documentation Hub Logo
Firmware/Features

Advanced Features

Learn about the advanced features available in LuxOS.

Advanced Features

The following settings can be found in LuxOS under Settings -> Advanced Settings

Stratum Settings

Smart Switch

Enables Luxminer to automatically revert to the primary mining pool when it becomes available again. This helps ensure maximum mining efficiency.

  • True: Enabled.
  • False: Disabled.

Smart Switch Seconds

Specifies how often (in seconds) Luxminer checks if the primary pool is available. Default: 60

Timeout Seconds

Defines the timeout in seconds for each connection attempt to a mining pool. Default: 5

Max Errors

Sets the maximum number of errors allowed before switching pool priority. Default: 5

Backoff On Error

Enables incremental backoff on subsequent connection errors, helping the miner avoid repeated failed connections when the network is unstable.

  • True: Enabled.
  • False: Disabled.

Hash On Disconnect

Enables the miner to continue hashing with no pool or network connectivity.

  • True: Enabled.
  • False: Disabled (default).

Stratum settings

Auto Updates

Source

Software Branches

Selecting a software branch will impact both automatic updates and manual firmware updates.

Specifies the type of updates LuxOS will download:

  • Stable: Production-ready updates.
  • Preview: Beta versions for early access.
  • Testing: Experimental updates for advanced users.

Timeout

Defines the interval (in minutes) for checking new updates. Default: 60

On Timeout

Determines the action LuxOS takes when a Timeout interval occurs:

  • Off: No action.
  • Download: Downloads updates but does not apply them.
  • Apply: Downloads and applies updates.
  • Full: Downloads, applies updates, and restarts the miner.

On Startup

Determines the action LuxOS takes on miner startup:

  • Off: No action.
  • Download: Downloads updates but does not apply them.
  • Apply: Downloads and applies updates.
  • Full: Downloads, applies updates, and restarts the miner.

On User

Determines the action triggered manually via the GUI or updaterun API:

  • Off: No action.
  • Download: Downloads updates but does not apply them.
  • Apply: Downloads and applies updates.
  • Full: Downloads, applies updates, and restarts the miner.

Auto update settings

Temperature Control

Required Sensors per Board

Specifies the minimum number of functional temperature sensors required per hashboard. If this threshold is not met, LuxOS will attempt to reboot the board or shut it down if issues persist. Options: 1, 2, 3, 4

Max Bad Readings

Sets the maximum number of consecutive bad temperature readings before considering the sensor "broken." Default: 10

Bad Avg Threshold

Determines the average temperature threshold above which readings are considered unreliable. Default: 2

Temperature Control settings

Fan Control

Power Off Speed

The fan power when the psu is powered off because of curtailment or a power-off event. Default: 20

Minimum Fan Speed

The minimum speed that the automatic fans can use. Default: 20

Maximum Fan Speed

The maximum speed that the automatic fans can use. Default: 100

Minimum Required Fans

The minimum number of fans that must be operational for the system to run. Options: 1, 2, 3, 4

Quiet Fan Startup

Sets fan initialization speed to minimum fan speed.

  • True: Enabled.
  • False: Disabled (default).

Immersion Mode

Immersion mode disables all fans.

  • True: Enabled.
  • False: Disabled (default).

Advanced Features, Fan Control

Hashboard Settings

NoPIC Shutdown

LuxOS is able to run any miner (PIC & NoPIC) with a hashboard powered off. However, by default, LuxOS will power off NoPIC miners by powering off hashboards and disabling the PSU when a hashboard fails preventing from sending voltage to failing hashboards. This feature can be disabled by the user. To do so, go into Settings, click on the Advanced Settings section, then scroll down to disable the NoPIC Hashboard Protection setting. Alternatively, users can disable this functionality through the API by calling the hashboardoptsset command or with LuxOS Commander.

  • True: Enabled (default).
  • False: Disabled.

OverTempAutoRecovery

As standard behavior, LuxOS will attempt to recover a hashboard that was powered off due to reaching the dangerous temperature. If the hashboard is still reaching the dangerous temperature after 5 attempts of being powered on, LuxOS will power off the hashboard and will not attempt to further recover it. This behavior can be disabled by the user. To do so, go into Settings, click on the Advanced Settings section, and disable the
Over Temp Auto Recovery setting. Alternatively, users can disable this functionality through the API by calling the hashboardoptsset command or with LuxOS Commander. If this feature is disabled, LuxOS will turn off hashboards and disable the PSU when any hashboard reaches the dangerous temperature.

  • True: Enabled (default).
  • False: Disabled.

Advanced Features, NoPIC Shutdown and OverTempAutoRecovery

PSU Control

PSU Bypass

Gives the user the ability to hash with a psu that is unrecognized by LuxOS.

  • True: Enabled.
  • False: Disabled (default).

Bypass Voltage

Available only when PSU Bypass enabled = True, allows the user to pass a static voltage value that LuxOS will use for power estimation calculations. Default: 12

Uninstall Firmware

This option allows users to remove LuxOS from the miner.

To uninstall LuxOS:

  1. Navigate to Settings > Advanced Settings > Uninstall Firmware, and select Uninstall.
  2. Follow the on-screen instructions to complete the uninstall process.

Uninstall LuxOS setting