Technician Mode

Pinman services

The Pinman Services page reports the background processes that support the connected Machine. Use it to check their state, inspect recent logs, or restart an individual service.

The page keeps service state and the active environment together:

Pinman Services page with service rows and the Environment panel

These are Pinman's own services. Windows services on the Machine appear on the Machine page.

Service rows#

Each row shows the service name, state, and port where applicable.

Status dotGreen is running, amber is restarting, and red is stopped.
PortShows the TCP port used by that service. The Scheduler runs inside the API and has no port.
LogsOpens the latest 100 lines beneath the service row.
Refresh logsLoads the current log tail. Newly loaded lines are emphasized.
RestartRestarts one service and follows its state until it returns.

Open Logs to inspect the current tail without leaving the page:

Expanded API Service log

Restarting the API asks for confirmation because the browser will disconnect briefly. The page reconnects when the API returns.

Services shown#

ServicePurpose
API ServiceConnects the UI and CLI with the active Project and Machine.
Audio ServiceSupports Pinman's audio features.
Overlay ServiceSupports the Operator overlay when Operator mode is enabled.
Inputs ServiceHandles Operator input controls when Operator mode is enabled.
SchedulerRuns scheduled work inside the API. It appears only while active.

The tray supervises the API and sidecar services. If several services need to be restarted together, use Restart Pinman from the tray menu or pinman service restart.

Environment#

The Environment panel identifies the data and configuration used by the running API.

EnvironmentThe active Pinman environment.
ProjectThe Project currently loaded by the service.
HubThe root of Pinman's local data.
DatabaseThe active Project database.
Config fileThe configuration file read by this service.
Backups rootThe location used for file backups.
Machine read-onlyReports whether Machine writes are blocked.

Command-line equivalents#

TaskCommand
Check the service treepinman service status
List individual servicespinman service list
Inspect one servicepinman service show NAME
Read its logpinman service logs NAME
Restart one servicepinman service restart NAME
Restart Pinmanpinman service restart