OS Manuals

/usr/bin/ytt

YAML templating tool that works on YAML structure instead of text

From ytt 0.55.4-r2 (os), captured 2026-11-05 by running ytt --help (exit 0). permalink

Also provided by 1 other package version
ytt performs YAML templating.

Docs: https://carvel.dev/ytt/docs/latest/
Docs for data values: https://carvel.dev/ytt/docs/latest/ytt-data-values/

Usage:
  ytt [flags]
  ytt [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  fmt         Format YAML templates
  help        Help about any command
  template    Process YAML templates (deprecated; use top-level command -- e.g. `ytt -f-` instead of `ytt template -f-`)
  version     Print version
  website     Starts website HTTP server

Flags:
      --allow-symlink-destination strings           File paths to which symlinks are allowed (can be specified multiple times)
      --bulk-in string                              Accept files in bulk format
      --bulk-out                                    Output files in bulk format
      --dangerous-allow-all-symlink-destinations    Symlinks to all destinations are allowed
      --dangerous-data-values-disable-validation    Skip validating data values (not recommended: may result in templates failing or invalid output)
      --dangerous-emptied-output-directory string   Delete given directory, and then create it with output files
  -v, --data-value stringArray                      Set specific data value to given value, as string (format: all.key1.subkey=123) (can be specified multiple times)
      --data-value-file stringArray                 Set specific data value to contents of a file (format: [@lib1:]all.key1.subkey={file path, HTTP URL, or '-' (i.e. stdin)}) (can be specified multiple times)
      --data-value-yaml stringArray                 Set specific data value to given value, parsed as YAML (format: all.key1.subkey=true) (can be specified multiple times)
      --data-values-env stringArray                 Extract data values (as strings) from prefixed env vars (format: PREFIX for PREFIX_all__key1=str) (can be specified multiple times)
      --data-values-env-yaml stringArray            Extract data values (parsed as YAML) from prefixed env vars (format: PREFIX for PREFIX_all__key1=true) (can be specified multiple times)
      --data-values-file stringArray                Set multiple data values via plain YAML files (format: [@lib1:]{file path, HTTP URL, or '-' (i.e. stdin)}) (can be specified multiple times)
      --data-values-inspect                         Determine the final data values (applying any overlays) and display that result
      --data-values-schema-inspect                  Determine the complete schema for data values (applying any overlays) and display the result (only OpenAPI v3.0 is supported, see --output)
      --debug                                       Enable debug output
  -f, --file stringArray                            File(s) to process {filepath, HTTP URL, or '-' (i.e. stdin)} (can be specified multiple times)
      --file-mark stringArray                       File mark (ie change file path, mark as non-template) (format: file:key=value) (can be specified multiple times)
      --file-mark-relaxed                           Do not error if a file path pattern containing '*' matches no files
      --files-inspect                               Determine the set of files that would be processed and display that result
  -h, --help                                        help for ytt
      --ignore-unknown-comments                     Configure whether unknown comments are considered as errors (comments that do not start with '#@' or '#!')
      --implicit-map-key-overrides                  Configure whether implicit map keys overrides are allowed
  -o, --output strings                              Configure output format. Can specify file format (yaml, json, pos) and/or schema type (openapi-v3) (can be specified multiple times) (default [yaml])
      --output-files string                         Add output files to given directory
  -s, --strict                                      Configure to use _strict_ YAML subset
      --version                                     version for ytt

Use "ytt [command] --help" for more information about a command.
Options (26)
OptionDescriptionSource
--allow-symlink-destination stringsFile paths to which symlinks are allowed (can be specified multiple times)help
--bulk-in stringAccept files in bulk formathelp
--bulk-outOutput files in bulk formathelp
--dangerous-allow-all-symlink-destinationsSymlinks to all destinations are allowedhelp
--dangerous-data-values-disable-validationSkip validating data values (not recommended: may result in templates failing or invalid output)help
--dangerous-emptied-output-directory stringDelete given directory, and then create it with output fileshelp
-v, --data-value stringArraySet specific data value to given value, as string (format: all.key1.subkey=123) (can be specified multiple times)help
--data-value-file stringArraySet specific data value to contents of a file (format: [@lib1:]all.key1.subkey={file path, HTTP URL, or '-' (i.e. stdin)}) (can be specified multiple times)help
--data-value-yaml stringArraySet specific data value to given value, parsed as YAML (format: all.key1.subkey=true) (can be specified multiple times)help
--data-values-env stringArrayExtract data values (as strings) from prefixed env vars (format: PREFIX for PREFIX_all__key1=str) (can be specified multiple times)help
--data-values-env-yaml stringArrayExtract data values (parsed as YAML) from prefixed env vars (format: PREFIX for PREFIX_all__key1=true) (can be specified multiple times)help
--data-values-file stringArraySet multiple data values via plain YAML files (format: [@lib1:]{file path, HTTP URL, or '-' (i.e. stdin)}) (can be specified multiple times)help
--data-values-inspectDetermine the final data values (applying any overlays) and display that resulthelp
--data-values-schema-inspectDetermine the complete schema for data values (applying any overlays) and display the result (only OpenAPI v3.0 is supported, see --output)help
--debugEnable debug outputhelp
-f, --file stringArrayFile(s) to process {filepath, HTTP URL, or '-' (i.e. stdin)} (can be specified multiple times)help
--file-mark stringArrayFile mark (ie change file path, mark as non-template) (format: file:key=value) (can be specified multiple times)help
--file-mark-relaxedDo not error if a file path pattern containing '*' matches no fileshelp
--files-inspectDetermine the set of files that would be processed and display that resulthelp
-h, --helphelp for ytthelp
--ignore-unknown-commentsConfigure whether unknown comments are considered as errors (comments that do not start with '#@' or '#!')help
--implicit-map-key-overridesConfigure whether implicit map keys overrides are allowedhelp
-o, --output stringsConfigure output format.help
--output-files stringAdd output files to given directoryhelp
-s, --strictConfigure to use _strict_ YAML subsethelp
--versionversion for ytthelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.