runtime.yml

.foundry/runtime.yml is committed and shared with the team. It declares how to run each service — ports, start commands, environment variables, and health checks.

Generation

Generated by foundry init from the manifest and filesystem detection. Regenerate with:

foundry init --regenerate-runtime

Structure

# .foundry/runtime.yml
generatedAt: "2025-01-01T00:00:00Z"
generatedFrom: foundry.json

services:
  platform-microlith:
    kind: backend
    type: spring-boot
    port: 8081
    managementPort: 18081
    command: ./mvnw spring-boot:run
    args:
      - -Dspring-boot.run.profiles=local
    env:
      SPRING_DATASOURCE_URL: jdbc:postgresql://localhost:5432/platform
    healthCheck:
      path: /actuator/health
      port: 18081

  hub-frontend:
    kind: frontend
    type: nextjs
    port: 3000
    packageManager: pnpm
    command: pnpm dev --filter hub-frontend
    env:
      NEXT_PUBLIC_API_URL: http://localhost:8081

Port Assignment

Ports are assigned by convention:

Editing

You can edit runtime.yml by hand — Foundry won't overwrite it unless you explicitly run --regenerate-runtime. Team members pull changes via Git.