foundry run

Launch all enabled services defined in the platform manifest.

Usage

foundry run [OPTIONS] [SERVICES...]

Options

FlagDescription
SERVICESOptional list of specific service names to run
--helpShow help message

Behaviour

Reads .foundry/runtime.yml for ports, commands, and environment variables. Launches each service in a managed subprocess with colour-coded log output.

Services are started in dependency order where possible. Backends launch before frontends. Health check endpoints are polled to confirm readiness.

Runtime Configuration

Port assignments, start commands, and environment variables come from .foundry/runtime.yml, not from foundry.json. The manifest declares what services exist; the runtime config declares how to run them.