Skip to content

Choose an interface

gatOS has one live snapshot and command model, but it does not force every consumer to pretend it is a filesystem. Choose the shape that makes the job pleasant.

InterfaceBest forWhere it runsStart here
/simshell work, guest programs, discoveryAlpine guestFilesystem overview
HTTP /v1dashboards, browser tools, simple host scriptshost and guestHTTP overview
MQTTpub/sub telemetry and automation toolinghost and guestMQTT overview
MCPAI agents and structured tool clientshostMCP overview
Virtio serialhardware-style telemetry and SCPIAlpine guest deviceSerial overview

/sim is the richest human exploration surface. HTTP and MQTT project the same snapshot and command pipeline, including an optional per-field mirror. MCP deliberately groups the model into logical JSON resources and tools instead of reproducing thousands of paths. Serial is a focused bridge, not a full transport twin.

HTTP, MQTT, and MCP bind to 127.0.0.1 by default. Their *_bind_host settings accept a specific host-interface IP or a wildcard such as 0.0.0.0 when another machine needs direct access. Those services do not gain authentication when exposed, so choose the reachable interface deliberately.