LOCALSEARCH-DAEMON(1)

💖 LOCALSEARCH-DAEMON(1) 💖

okay so bestie, welcome to localsearch-daemon from the LocalSearch manual — this is the page that tells you how to start, stop, restart and list the daemons responsible for indexing your content. grab a snack, we're doing this together ✨

---

🌸 NAME 🌸

localsearch-daemon — start, stop, restart and list the daemons that are out here indexing your content, fr fr

---

🦋 SYNOPSIS 🦋

localsearch daemon [options...]
localsearch daemon -s | -t [daemons] | -k [daemons] | -l
localsearch daemon -f | -w [ontology]
localsearch daemon --miner <miner> --pause[-for-process] <reason>
localsearch daemon --miner <miner> --resume <cookie>

---

✨ DESCRIPTION ✨

So here's the vibe: Tracker indexes content using daemon processes that run in the background, lowkey just doing their thing while you live your life. The localsearch daemon command is your remote control for all of that 💅 — starting them, stopping them, killing them, pausing them, resuming them. The whole range. Iconic behavior honestly.

And not only that, there are also ways to follow or watch what's happening in real time, from the top-level view all the way down to where the SPARQL commits are actually happening. main character surveillance energy, we love to see it 👑

If you pass no arguments at all? This command will just show you the current status of all Tracker data miners. A lil status check, no notes. 🫶

The data miners can be paused or resumed with this command too, and you can also list the miners that are running and the ones that are available. multitasking queen behavior.

---

💜 OPTIONS 💜

• -p, --list-processes — lists all the Tracker processes chillin' in the system. every single one.
• -k, --kill — this one uses SIGKILL to stop all Tracker processes matching the parameter. If you don't pass an extra parameter, "all" is assumed. 💀 ngl this is not advised unless you were already having problems stopping Tracker in the first place. This one GUARANTEES death. no negotiation, no goodbye, it's giving ghosting but permanent.
• -t, --terminate= — this one uses SIGTERM to stop all Tracker processes. This is recommended over --kill because it gives the processes time to shut down cleanly. polite queen behavior, we stan a graceful exit ✨
• -s, --start — starts all miners. let's get this bread.
• -f, --follow — follow status changes to daemons as they happen. This is a top-level view of what's going on — you'll see the name for each daemon and a state, plus the progress in that state. like a livestream but for daemons 🍓

This one requires Ctrl+C to stop and return to the command line. Each new status gets put on a new line. no cap.

• -w, --watch=[ontology] — watch changes that happen to the database in real time. This also requires Ctrl+C to stop and return to the command line.

If ontology is unspecified, all updates are shown. The ontology can be a comma separated list of shorthand or long hand ontology properties. For example:

$ localsearch daemon -w nie:url,nie:mimeType,nfo:fileSize,nie:dataSource
Now listening for resource updates to the database
All nie:plainTextContent properties are omitted

Press Ctrl+C to stop

'nfo:Document'
   'nfo:fileSize' = '1770'
   'nie:dataSource' = 'http://tracker.api.gnome.org/ontology/v3/tracker#extractor-data-source'
   'nie:mimeType' = 'text/plain'
   'nie:url' = 'file:///home/martyn/.bash_aliases'
'nfo:Document'
   'nie:dataSource' = 'http://tracker.api.gnome.org/ontology/v3/tracker#extractor-data-source'

...

• --list-common-statuses — this will list statuses most commonly produced by miners and the store. Heads up though: these statuses are not translated when sent over D-Bus, so each application is supposed to translate them itself. Also, these are not considered static and are subject to change at any point. ⚠️ so don't go building your whole personality on them.

Additionally — and this is important bestie — these statuses are not the only ones which may be reported by a miner. There may be other states pertaining to the specific roles of the miner in question. iykyk.

• --list-miners-running — this will list all miners which have responded to a D-Bus call. Sometimes it's helpful to use this command together with --list-miners-available. dynamic duo fr fr.
• --list-miners-available — this will list all miners which are available, even if they are not running at the moment. bench warmers, but make it D-Bus.
• --pause-details — for listing all miners which are paused and the reasons for being paused, you can use this. It will also display the application that requested the pause too. 🕵️‍♀️ full receipts.
• --miner=<miner> — this argument is used with --pause or --resume to say which miner you want to pause or resume. You can use the full D-Bus name, e.g. "org.freedesktop.Tracker3.Miner.Files" OR you can use the suffix, e.g. "Files". either way, we know who you mean 💅
• --pause=<reason> — the reason here is useful to know WHY the miner should be paused. A miner can be paused many times by multiple applications. Only when all pauses have been resumed will it continue. If it's successful, a cookie will be given to uniquely identify the request. That cookie is used to resume the pause at a later stage. 🍪 keep it safe bestie.
• --pause-for-process=<reason> — this works exactly the same way as --pause, with the exception that it only keeps the pause active while the calling process is alive. As soon as you press Ctrl+C, the pause is resumed automatically. it's giving "if you leave, we're done" 😭
• --resume=<cookie> — the cookie is given by a successful --pause command. It's a number which identifies each pause request. When all pauses have been resumed, the miner will resume working. cookie redeemed, miner un-paused, we're so back 🔥

---

lowkey reminder: the --kill option GUARANTEES death and is not advised unless you're already stuck. --terminate is the clean, recommended way. choose peace 🧚

---

and that's the whole page bestie, you ate that 🎀 this was LocalSearch manual version 3.8.2, dated 02/03/2026, and it's filed under LOCALSEARCH-DAEMON(1) — periodt. now go index something 💖✨🌸