CloudTruth Environments allow you to model your organizations hierarchy and define parameter values specific to the Environment you are working in.
Each CloudTruth Organization starts with a default Environment as the parent and development, production and staging. Parameters inherit values from branches in the Environment tree allowing you to have a common default value throughout the Organization while also granting fine grain control over those values where required.

Creating an Environment

Navigate to the Environments page from the left hand menu and click Add Environment.
Provide the Environment a name and an optional description under the development parent and click Create Environment.
This will create a new Environment as a child of the development Environment.

Environment Hierarchy

In this example, we've created three additional Environments under development. (dev1, dev2, dev3) as children of the development environment.
You can create multiple branches when adding an Environment. From the Create New Environment dialogue select which branch to be the parent. The parent Environment will default to the Environment selected in the Environment Management page but can be changed to anything in the tree.
This process can be repeated for complex models allowing very distinct parameter customization at multiple levels of your organization.


Tagging allows you to create a snapshot of parameters and values in a selected environment to a specific point in time. You can then use that tag to retrieve values for your applications. Tags are applied in the environment across all projects in your organization. You can use tags to retrieve values for that tag on our history page or the CLI.

Creating a tag

Select the environment in the tree and Click Create Tag to open up the create tag dialogue.
Provide a name and an optional timestamp for the tag.
The current time is automatically selected by default, but you can create a tag from a previous point in time!
Select Immutable to prevent tags from being updated to reflect recent changes.

Managing tags

You can edit the timestamp or description of a tag from the environment tag menu. Editing the timestamp of a tag will allow you to perform certain workflows like snapping a tag called stable to the current time.
The environment tags menu also allows you to delete your tags.

Deleting an Environment

Selecting an Environment brings up the Environments management screen which allows you to modify the description or delete the selected Environment.
Selecting Delete Environment will prompt you with a confirmation, deleting an Environment may impact any configuration referencing Parameters from that Environment.
You will not be allowed to delete the Default Environment or a Parent Environment that contains children.