Skip to content


The version directive in Terrateam allows you to specify the version of the Terrateam configuration file. This helps ensure compatibility between your configuration and the Terrateam runtime.


Version is configured in the .terrateam/config.yml file under the version key. Here’s the default configuration:

version: "1"

Version options

The version key should be set to a string value representing the version number of the configuration file.

versionStringConfiguration file version number. Default is "1".


Using the default version

version: "1"

This configuration specifies that the Terrateam configuration file is using version "1", which is the default.

Specifying a Different Version

version: "2"

This configuration specifies that the Terrateam configuration file is using version "2". Note that this is just an example, and version "2" may not exist or be supported by your current Terrateam runtime.


When setting the version in your Terrateam configuration, keep the following in mind:

  • The default version is "1", and it is recommended to use this version unless you have a specific reason to use a different version.
  • When Terrateam introduces breaking changes or new features that require a different configuration format, it may introduce a new version number. In such cases, you will need to update the version key in your configuration file to match the required version.
  • Before updating the version in your configuration file, ensure that your Terrateam runtime supports the specified version. Consult the Terrateam documentation or release notes to determine which versions are supported by your runtime.
  • If you are working with multiple repositories or projects, it is a good practice to keep the version consistent across all configuration files to avoid confusion and ensure compatibility.
We use cookies and similar technologies to provide certain features, enhance the user experience and deliver content that is relevant to your interests. Depending on their purpose, analysis and marketing cookies may be used in addition to technically necessary cookies. By clicking on "Agree and continue", you declare your consent to the use of the aforementioned cookies. Here you can make detailed settings or revoke your consent (in part if necessary) with effect for the future. For further information, please refer to our Privacy Policy .