Skip to main content

Development launchers

For an installed local bundle, use transit server as described in the quickstart. Repository contributors also use launchers to build and exercise concrete development deployments. Launchers compose services; Transit history remains execution authority.

PlacementEnvironmentLifecycle and limits
LocalNative processes on a trusted development hostPersistent disk state, Board and example workers; shares the local OS account
ComposeContainerized servicesPersistent volumes and explicit service replacement; requires a container engine
ReferenceKubernetes with Agent SubstrateProvider-managed placement with scoped runtime authority; infrastructure has a separate lifecycle

Each launcher distinguishes building candidate artifacts, updating a deployment and restarting its selected version. Stopping preserves data; resetting deletes a stopped installation explicitly. A provider restart cannot grant execution rights or revive a retired process. Compatible replacement preserves logical identity and current permissions; incompatible definitions require a hard cutover.

The repository launcher runbook owns setup, commands, configuration, artifact selection and recovery procedures for these development systems. Deployment and recovery explains the runtime boundaries and unsupported recovery cases. The proof ledger records executed placement checks and limits.