Other Fields

Field Type Description
restart enum Restart policy: always (restart unconditionally), on-failure (restart only on non-zero exit), no (never restart)
schedule string Cron expression for scheduled jobs
singleton boolean When true, the platform must not run more than one instance of this component
platform string | string[] OCI platform constraint (e.g. linux/amd64, linux/arm64)
host object Host-level constraints (see Host)

schedule

Standard 5-field cron format: minute hour day-of-month month day-of-week.

schedule: "0 0 * * *"    # daily at midnight
schedule: "*/15 * * * *"  # every 15 minutes

Platforms MAY additionally support a 6-field format with seconds (second minute hour dom month dow) and shortcut aliases (@daily, @hourly, @weekly). Files targeting broad compatibility should use the 5-field format.

platform

Follows the OCI image platform specification: os/architecture[/variant]. Accepts a single string or an array for multi-platform support.

# Single platform
platform: linux/amd64

# Multiple platforms
platform:
  - linux/amd64
  - linux/arm64

Common values: linux/amd64, linux/arm64, linux/arm/v7 (Raspberry Pi 32-bit). The Launchfile targets containerized and server deployments; bare-metal microcontroller platforms (Arduino, ESP32) are outside its scope.

See examples/cron-job.yaml and examples/prebuilt-image.yaml for full examples.

esc
Type to search the docs