FirmwareAPI DocumentationLUXminer commands
recoverctrlset
Sets recovery configuration parameters
recoverctrlset
Description
Changes the recovery configuration. Parameters are passed as a session id followed by key=value pairs; any parameter you omit keeps its current value.
Note: If autosave is disabled, the changes will be lost after a reboot.
Command
$ echo '{"command": "recoverctrlset", "parameter":"yJN2nlj1,enabled=true,max_per_hour=3,max_per_day=20,max_consecutive_errors=15,cooldown_minutes=3"}' | nc $MINER_IP 4028 | jqExamples
$ echo '{"command": "recoverctrlset", "parameter":"yJN2nlj1,enabled=true,max_per_hour=3,max_per_day=20,max_consecutive_errors=15,cooldown_minutes=3"}' | nc $MINER_IP 4028 | jq
{
"STATUS": [
{
"Code": 365,
"Description": "LUXminer 2026.6.1.194014-8dd68647e",
"Msg": "Recovery control configuration updated",
"STATUS": "S",
"When": 1780403947
}
],
"id": 1
}Parameters
| Parameter | Notes |
|---|---|
session_id | A valid session ID. See Session Management for details. |
enabled | Master on/off switch for automatic board recovery. true or false. When false, a failed board is powered off and left off, with no recovery attempts. |
max_per_hour | Maximum recovery attempts per board within a rolling one-hour window. |
max_per_day | Maximum recovery attempts per board within a rolling 24-hour window. |
cooldown_minutes | Minutes to wait before allowing another recovery attempt. |
max_consecutive_errors | All-time consecutive errors before a board is considered irrecoverable. |