Skip to content

Host

Reads a machine’s systemd services through the Valet agent. This shows what’s running and what failed, and the assistant can read logs. The agent can only look.

config.yaml
integrations:
host:
type: host
url: http://10.0.0.5:7576
token: ${HOST_TOKEN}
title: Services
quiet:
- restic-backup
layout:
- title: Infrastructure
widgets:
- host.services
OptionTypeDefaultWhat it does
urlURLrequired172.17.0.1:7576
tokenstringrequiredThe agent’s token. Use ${VAR}.
titlestringServicesThe card’s title.
quietlist of string[]often off on purpose: shown grey when stopped, never an alert

One widget. Its key is host.services, using the instance name from your config.

host.services · status card · refreshes every 30 seconds while the page is open.

Host, Services, small size
Small
Host, Services, wide size
Wide
Host, Services, medium size
Medium
Host, Services, large size
Large
Host, Services, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

Host Services: A service failed
A service failed
Host Services: Can't reach it
Can't reach it

What the assistant can use, once its access level allows it. Read tools run freely. Everything else asks first.

ToolAccessWhat it does
services_statusreadServices running directly on this machine rather than in Docker (systemd): state, since when, how many times they restarted, how they last ended, memory.
service_logsreadRecent logs of a service running directly on this machine (systemd).