Ubuntu 24.04 LTS – tracker-miner-fs causes high CPU usage – 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

Desktop responsiveness degrades due to sustained indexing CPU load.

Environment & Reproduction

Often triggered by large file trees or frequent content changes.

top -o %CPU

Root Cause Analysis

Tracker indexer repeatedly scans high-churn directories and large binary assets.

Quick Triage

Confirm tracker process activity and indexed paths.

ps -ef | grep tracker-miner-fs
tracker3 status

Step-by-Step Diagnosis

Inspect indexer logs and current user configuration for excluded paths.

journalctl --user -n 120 | grep tracker
gsettings get org.freedesktop.Tracker3.Miner.Files ignored-directories

Solution – Primary Fix

Reset tracker index and exclude heavy folders from indexing.

tracker3 reset --filesystem
gsettings set org.freedesktop.Tracker3.Miner.Files ignored-directories "['node_modules', 'VMs', 'backups']"

Solution – Alternative Approaches

Temporarily disable miner services for non-desktop production workloads.

systemctl --user mask tracker-miner-fs-3.service

Verification & Acceptance Criteria

CPU usage normalizes and desktop interaction latency improves.

tracker3 status
ps -eo pid,pcpu,comm | grep tracker

Rollback Plan

Unmask and restart tracker miner if search functionality is required.

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

Prevention & Hardening

Exclude build and backup directories from index scope by default.

Related Errors & Cross-Refs

Can coincide with high disk I/O and elevated laptop fan noise complaints.

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

View all Ubuntu 24.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

GNOME Tracker 3 tuning guidance for Ubuntu desktop environments.