validate
Validate a Runix configuration file.
Usage
runix validate [config-file] [flags]
Description
Validates a runix.yaml configuration file for errors, duplicate names, invalid runtimes, bad paths, and circular dependencies.
Examples
# Validate runix.yaml in current directory
runix validate
# Validate a specific file
runix validate /path/to/runix.yaml
# Validate using the --config flag
runix validate --config staging.yaml
Validation Checks
| Check | Error Example |
|---|---|
| File exists | config file "runix.yaml" not found |
| YAML is parseable | failed to parse config: yaml: line 5: could not find expected ':' |
| Process names are unique | duplicate process name "api" |
| Runtime is valid | invalid runtime "foobar" for process "api" |
| Entrypoint is specified | entrypoint is required for process "api" |
| Cron schedules are valid | invalid cron schedule "not-a-cron" |
| No circular dependencies | circular dependency detected: a → b → a |
| max_restarts ≥ 0 | max_restarts must be >= 0 |
Output
Configuration valid: 5 process(es), 2 cron job(s)
Or on failure:
Validation failed: duplicate process name "api" in namespace "default"
What's Next
- Configuration Reference — Full YAML schema