foundry run

Start Foundry services locally in a unified Services UI. run is a command group with two subcommands — dev and build.

Usage

foundry run [-d|--debug] dev   [--filter NAMES] [--migrate-db]
foundry run [-d|--debug] build [--filter NAMES]

The -d/--debug flag is on the group and must appear before the subcommand (aliases hoist it automatically).

Subcommands

Subcommand	Description
`dev`	Run the platform in development mode with the Services UI
`build`	Run the build command for all services

Options

Flag	Applies to	Description
`--filter`	`dev`,`build`	Comma-separated service names to run (dependencies are included automatically)
`--migrate-db, -mdb`	`dev`	Run Liquibase migrations before starting services that have a `database` block
`--debug, -d`	group	Show debug output

The Services UI

run dev discovers each enabled service from .foundry/workspace.yml and launches it in a managed runner. Sidecars appear as sub-items nested under their parent service. Service launch behavior — ports, commands, env, health checks — is resolved from the manifest's run block and detected framework conventions, not from a separate runtime file.

Examples

foundry run dev                       # all enabled services
foundry run dev --filter api,web      # just these (plus their deps)
foundry run dev --migrate-db          # migrate databases first
foundry run build                     # build all services