How to Check the Battery Health and Cycle Count of Your Laptop in Ubuntu Terminal

Unlike desktop computers, a laptop’s lifespan is heavily dictated by the health of its internal battery. Over time, lithium-ion batteries degrade, holding less charge and eventually requiring replacement. If your Ubuntu laptop is suddenly shutting down at 20% or struggling to hold a charge for more than an hour, you should investigate the physical health of the battery.

While graphical power management tools exist, the Ubuntu terminal provides the most detailed, unfiltered access to the hardware data reported directly by the battery’s internal management system. You can easily query this information using built-in system tools to determine your battery’s current capacity and cycle count.

Understanding Cycle Counts

A “charge cycle” occurs when you use 100% of your battery’s capacity, but not necessarily all at once. For example, if you use 50% of your battery today, fully recharge it, and use 50% again tomorrow, that counts as one single charge cycle. Most modern laptop batteries are rated to maintain at least 80% of their original capacity for roughly 500 to 1,000 charge cycles. Knowing this number gives you a clear indication of how much life is left in your hardware.

Using the UPower Utility

The standard tool for interacting with power devices in Ubuntu is upower. It can list all connected power sources and extract detailed hardware reports.

1. Open your terminal by pressing Ctrl + Alt + T.
2. First, you need to find the specific system path for your laptop battery. Type the following command and press Enter:
   upower -e
3. This will print a list of power devices. Look for the line that ends with BAT0 or BAT1 (for example: /org/freedesktop/UPower/devices/battery_BAT0). This is your primary battery.
4. Now, ask upower for a detailed report on that specific device by typing upower -i followed by the path you just found. For example:
   upower -i /org/freedesktop/UPower/devices/battery_BAT0

Interpreting the Battery Report

The terminal will output a long list of statistics. Look for these specific lines to judge the health of your hardware:

• energy-full-design: This is the amount of energy the battery could hold when it was brand new, straight from the factory.
• energy-full: This is the maximum amount of energy the battery can hold right now.
• capacity: This is a percentage representing energy-full divided by energy-full-design. If this number is below 80%, your battery has significantly degraded. If it drops below 50%, the battery is failing and should be replaced.

Unfortunately, not all laptop manufacturers allow upower to read the cycle count. If you do not see a “cycle-count” line in the upower output, you can try reading the kernel files directly.

Reading the Sysfs Files Directly

If upower fails to display the cycle count, you can query the Linux sysfs virtual file system, which exposes kernel hardware data directly to the user.

1. In the terminal, type the following command to check if your battery is reporting cycle data to the kernel:
   cat /sys/class/power_supply/BAT0/cycle_count
   (Note: Change BAT0 to BAT1 if necessary based on your previous findings).
2. If the system returns a number (e.g., 342), that is your exact charge cycle count. If it returns an error or a 0, it means your specific laptop manufacturer has locked that data at the firmware level, and it cannot be read by the operating system.