Ubuntu 26.04 LTS – high CPU caused by tracker-miner or indexing services – Fix & Prevention

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Sustained high CPU degrades responsiveness and can starve critical workloads.

Environment & Reproduction

Common after large file syncs, first-login indexing, or media library changes.

uptime
ps -eo pid,comm,%cpu --sort=-%cpu | head
top -b -n1 | head -n 20

Root Cause Analysis

Background indexers or misconfigured user services consume CPU continuously.

Quick Triage

Identify top CPU consumers and their cgroup context.

ps -eo user,pid,ppid,comm,%cpu --sort=-%cpu | head
systemd-cgls | head -n 80
journalctl -p warning -n 80 --no-pager

Step-by-Step Diagnosis

Correlate process spikes with recent filesystem and session activity.

sudo apt install -y sysstat
pidstat -u 1 5
ls -ltr ~/ | tail -n 20

Solution – Primary Fix

Throttle or disable unnecessary indexing services and restart session components.

systemctl --user stop tracker-miner-fs-3.service || true
systemctl --user mask tracker-miner-fs-3.service || true
renice +10 -p $(pgrep -f tracker-miner-fs-3 || echo 1)

Solution – Alternative Approaches

Exclude large folders from indexing instead of fully disabling the service.

mkdir -p ~/.config/tracker3
printf '[Miner
]' > ~/.config/tracker3/miners.cfg
tracker3 daemon -k || true

Verification & Acceptance Criteria

CPU utilization returns to expected baseline and remains stable under normal workload.

mpstat 1 5
ps -eo comm,%cpu --sort=-%cpu | head
uptime

Rollback Plan

Unmask and restart indexers if required features depend on search indexing.

systemctl --user unmask tracker-miner-fs-3.service || true
systemctl --user start tracker-miner-fs-3.service || true

Prevention & Hardening

Set performance baselines and alert on sustained CPU saturation.

sudo apt install -y dstat
dstat --cpu --top-cpu 1 5

Related Errors & Cross-Refs

Can overlap with I/O bottlenecks, swap pressure, and runaway user-session services.

Related tutorial: View the step-by-step tutorial for Ubuntu 26.04 LTS.

View all Ubuntu 26.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu performance diagnostics and systemd user-service administration references.