Advanced Features
The following settings can be found in LuxOS under Settings -> Advanced 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 (opens in a new tab).
- 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 (opens in a new tab). 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.
Logging Level
Changing the logging level requires a Luxminer restart. You can restart Luxminer using the 3 line drop-down menu in the top right corner of every page.
Defines the verbosity of the logs generated by LuxOS. The levels are:
- TRACE: Provides process level information, useful for enhanced debugging.
- DEBUG: Provides detailed information useful for debugging issues.
- INFO: Provides general information about system operation.
- WARN: Only logs items that can be issues, but do not need immediate user attention.
- ERROR: Only logs critical errors that require user attention.
- FATAL: Only logs items that are catastrophic to the miners operation.
To configure the logging level:
- Navigate to Settings > Advanced Settings > Logging.
- Select the desired logging level from the dropdown menu.
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.
Auto Updates
Source
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.
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
Uninstall Firmware
This option allows users to remove LuxOS from the miner.
To uninstall LuxOS:
- Navigate to Settings > Advanced Settings > Uninstall Firmware, and select Uninstall.
- Follow the on-screen instructions to complete the uninstall process.