Wheelhouse docs

Diagnostics — processes#

The Processes tab lists the processes running on the router. It refreshes every 10 seconds.

The four tiles#

TileValue
ProcessesAll the processes listed.
Kernel threadsProcesses whose command is in square brackets, such as [kworker/0:1]. The second line reads Shown in [brackets].
User processesAll the processes except kernel threads.
DefunctProcesses that have finished but have not been cleared by the process that started them (state Z). Amber when there are any.

A few defunct processes that clear by themselves are normal. A count that keeps growing means a process is not clearing the ones it started.

The table#

ColumnWhat it shows
PIDThe process ID.
StateThe process state. Green when it starts with R (running), red when it starts with Z (defunct).
CPU timeThe processor time the process has used since it started.
TerminalThe terminal it is attached to; ? for none.
CommandThe full command line.

Every column sorts. The filter, Filter by command…, matches any column. The list scrolls within the panel.

Using it#

QuestionHow
Is the Wheelhouse agent running?Filter for wheelhouse-agent.
Is an app's container running?Filter for conmon. An app's own page shows its state: Apps — detail.
Is the intrusion detection engine running?Filter for suricata.
Which process has used the most processor time?Sort by CPU time. It is the total since the process started, not its current use.

What this tab does not do#

  • No current processor or memory use per process. The columns are the ones above.
  • No stopping or restarting. Nothing on this tab acts on a process.
  • No history. Each refresh replaces the list.
  • No process tree. Processes are a flat list.

For the router's load and memory, see the Overview. For what a service is doing, see Logs.

For automation#

GET /api/processes (any role) returns the list, one object per process with its PID, terminal, state, processor time and command.

See also#

  • Diagnostics — the other five tabs.
  • Companions — whether each companion service is configured and running.
  • Logs — what a process is writing to the system log.

Updated 2026-09-18 manual diagnostics processes