Repository
Committed application source and a schema-version-1 manifest.
Execution layer / read-only view
Meet the machine
behind “it’s live.”
The app runner is the narrow bridge between a committed repository and a public FairyStack application. Explore what it sees, what it does, and where its authority stops.
RUNNER STATUS
R
Connecting…
- Version
- —
- Contract
- —
- Apps
- —
- Scan
- —
Waiting for first snapshot
01One narrow job.
Anatomy
One narrow job.
Four clear boundaries.
Runner
Validates the contract and hands work to the privileged lifecycle boundary.
Runtime
A managed system service bound to a dedicated local port.
Public URL
TLS-terminated HTTPS routed to the healthy application.
02What the runner
Live inventory
What the runner
can see right now.
A sanitized snapshot from the runner’s public read interface. No environment variables, logs, process arguments, or lifecycle credentials are exposed.
APPLICATIONSTATUSPORTREVISIONSOURCE
Loading live applications…
03Read broadly.
Surfaces
Read broadly.
Write narrowly.
GET
/api/versionRelease identity
Service name, runner version, and supported lifecycle contract.
PUBLIC · READ ONLYGET
/v1/healthRunner health
A minimal liveness response from the local execution service.
PUBLIC · READ ONLYGET
/v1/inventoryApplication inventory
Manifest metadata, runtime state, revision, and source size.
PUBLIC · READ ONLYPOST
/v1/apps/*Lifecycle operations
Deploy, restart, create, rename, and removal operations.
UNIX SOCKET · AUTHENTICATEDKNOWN BEHAVIOR / 001
Observed in this release
Deploy verifies health,
but may preserve an old process.
For an already-running service, activation does not necessarily replace the process. A changed server entrypoint can therefore remain unloaded even after a successful deployment receipt.
EXPECTED INVARIANTdeployed revision=running revision
This explorer documents the observation; it cannot invoke or alter lifecycle operations.
The trust boundary
Useful visibility.
Deliberately no control.
✓
This explorer can
Read version, health, and sanitized inventory metadata through loopback HTTP.
×
This explorer cannot
Reach the authenticated lifecycle socket, mutate apps, read secrets, or inspect private logs.