Home » How to Configure Fan Speed (Active Cooler) via Command Console
Systems & Servers

How to Configure Fan Speed (Active Cooler) via Command Console

✨ Quick Answer

Modern development boards and Mini PCs (such as the Raspberry Pi 5) offer incredible performance, but dissipate a lot of heat when running heavy Docker services or media servers. The use of an Active Cooler (active heatsink with fan) is mandatory to prevent thermal throttling (automatic power reduction due to excess temperature).

Quick Diagnostics

Cause
PWM fan control overlay not enabled in config.txt
Solution
Add dtparam=fan_temp0=60000 in /boot/firmware/config.txt
Cause
Thermal monitoring service inactive
Solution
Adjust thermal thresholds in raspi-config or check JST connector

Modern development boards and Mini PCs (such as the Raspberry Pi 5) offer incredible performance, but dissipate a lot of heat when running heavy Docker services or media servers. The use of an Active Cooler (active heatsink with fan) is mandatory to prevent thermal throttling (automatic power reduction due to excess temperature).

By default, the operating system manages the fan automatically, but often the factory thresholds are very high, allowing the board to reach 60°C before turning on the air, shortening the life of the hardware.

Step-by-Step Solution

  1. 1

    Step 1: Verificar la temperatura actual por consola

    Open the terminal of your Linux-based operating system and run the following command to know the exact processor temperature in real time:

    BASH
    vcgencmd measure_temp
    
  2. 2

    Step 2: Editar el archivo de configuración de arranque

    On systems based on Raspberry Pi OS, we can modify the activation parameters by editing the config.txt file. Open the editor with administrator privileges:

    BASH
    sudo nano /boot/firmware/config.txt
    

    (Nota: En versiones antiguas de sistemas operativos, la ruta puede ser simplemente /boot/config.txt).

  3. 3

    Step 3: Definir los nuevos umbrales de temperatura (Cooling Trip Points)

    Scroll to the end of the file and add the following lines to customize the exact degrees at which the fan will change speed (the values correspond to millidegrees Celsius, for example 50000 is equivalent to 50°C):

    PLAINTEXT
    # Ajuste personalizado del Active Cooler
    dtparam=fan_temp0=45000
    dtparam=fan_temp0_hyst=5000
    dtparam=fan_temp1=52000
    dtparam=fan_temp1_hyst=5000
    dtparam=fan_temp2=60000
    dtparam=fan_temp2_hyst=5000
    

    Save the file by pressing Ctrl + O, confirm with Enter and exit with Ctrl + X.

  4. 4

    Step 4: Reiniciar el sistema

    To apply hardware changes in the internal configuration tables, perform a clean reboot:

    BASH
    sudo reboot
    

Prevention Advice

Recommended security practices:

  • Avoid direct connections of generic fans to the 5V/GND GPIO pins without PWM control, because if the fan consumes too much current or you try to wire it incorrectly, you can cause a lethal short circuit that damages the board permanently (leaving it with a solid red LED of death). Always use official accessories connected to the dedicated JST fan connector.
Author • Web Designer & App Creator

Rodolfo Castro

Web designer, app developer, and founder of SoporteCero. Specializing in UI/UX architecture, digital products, and modern web environments. Every tutorial and guide on SoporteCero is thoroughly tested and verified in our technical lab to ensure reliable, up-to-date solutions.