fanset

Description

Updates the fan control options. The parameters are the session_id, followed by a comma-separated list of key-value pairs, in the format key=value. The available keys are:

• speed: set the power sent to the fans; 0-100 integer value for a fixed speed, or -1 to let luxminer control the fan speed automatically.
• min_fans: a zero or positive value indicating the minimum required number of fans.
• power_off_speed: is the fan power when the PSU is powered off because of curtailment or a power-off event.
• min_speed: is the minimum speed that the automatic fans can use (can't go lower than 20). Using -1 will set it to the default value.
• max_speed: is the maximum speed that the automatic fans can use (can't go lower than 50). Using -1 will set it to the default value.

Notes:

• If autosave is disabled, the changes will be lost after a reboot.
• This command will return an error for machines that do not natively have fans (i.e. Hydro and Immersion models).
• The command will fail if min_speed is greater than max_speed. Please use the limits command to check the valid values.

Command

$ echo '{"command": "fanset", "parameter":"yJN2nlj1,power_off_speed=20"}' | nc $MINER_IP 4028 | jq

Examples

In this example, we set the parameters using the legacy format, which allows setting only the speed and the minimum number of fans.

$ echo '{"command": "fanset", "parameter":"yJN2nlj1,-1,1"}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 300,
      "Description": "LUXminer 0.1.0-15436f7140",
      "Msg": "Fan Speed Set",
      "STATUS": "S",
      "When": 1667917473
    }
  ],
  "id": 1
}

In this example, we use the new format to change the bounds of the automatic fans:

$ echo '{"command": "fanset", "parameter":"PgpbeOVr,min_speed=30,max_speed=95"}' | nc $MINER_IP 4028 | jq
{
  "STATUS": [
    {
      "Code": 300,
      "Description": "LUXminer 2025.7.4.132455-443ed81e",
      "Msg": "Fan Speed Set",
      "STATUS": "S",
      "When": 1751635903
    }
  ],
  "id": 1
}

Parameters