Apps allow instances having general relationships to be grouped in a clean and organized manner. App functionality enables full control of which instances belong in an app as well setting Firewall and Access Control List (ACL) rules. Use Apps to structure all necessary components into a single place. Add checks and groups for web servers, database nodes, etc.

Apps can be created from Blueprints, which are made in Provisioning -> Blueprints or from Existing Apps.

Creating Apps from Blueprints

  1. Click +ADD on the right side of the main Apps section in Provisioning.

  2. Select an existing App Blueprint and click NEXT.


    Blueprints must be created in in Provisioning -> Blueprints. to appear as options when creating an App.

  3. Enter a Name for the App and select a Group. Default Cloud and Env can also be selected.

  4. Click NEXT. Blueprint configurations matching the Group, Cloud and Environment selections will auto-populate the configurations of the Instances in the App. If no Blueprint Configuration matched the Group, Cloud or Env selections, the Instances will have default configurations.

  5. Configure your Instances. Depending on the Blueprint Configurations settings, instances may already be fully configured. Fields that are locked in a Blueprint cannot be edited when creating an App.


    Once an Instance is fully configured, a green checkmark will appear next to the Instance. Instances that have required fields that need populated will have a red X and must be completed. If your Blueprint is already fully configured you can simply select complete!

  6. Select COMPLETE and the App will be created and the Instances will begin provisioning.


Creating Apps from Existing Instances

  1. Click +ADD on the right side of the main Apps section in Provisioning.

  2. Select APP FROM EXISTING INSTANCES from the Blueprints list and click NEXT.

  3. Enter a Name for the App and select a Group. Default Cloud and Env can also be selected.


    Only instances within the selected Group and Cloud will be available to be added to the App.

  4. In the STRUCTURE section, select + to add a Tier

  5. Select or enter a Tier Name.

  6. Select the Tier to set Boot Order, rename, or once multiple Tiers are added, connect the Tier to other Tiers.

  7. In the STRUCTURE section, select + in a Tier to add an Instance

  8. Select the Instance Type of the Existing Instance to be added to the App.

  9. In the STRUCTURE section, select the Instance.

  10. In the CONFIGURATION section, select the Cloud the Existing Instance is in. Existing INSTANCES that match the Group, Cloud and Instance Types set will populate.

  11. Select the desired Instance from the INSTANCES list. Selected instance will show in the SELECTED INSTANCE section.


    Only one existing Instance can be added per Instance. To add multiple Existing Instances, repeat the step above including adding an Instance for each Existing Instance to be added to the App.

  12. Once all Existing Instances have been selected, click COMPLETE.

  13. A new App will be created out of the Existing Instances.


Exporting JSON or YAML

  1. Navigate to Provisioning -> Apps
  2. On an existing App, select ACTIONS -> EXPORT
  3. Select YAML or JSON in the top right.
  4. Select the Configurations to include in the Export by clicking on a Configuration. Selected Configurations will be highlighted.
  5. Select the DOWNLOAD CONFIGURATION button.
  6. The Blueprint Export file will be downloaded to your computer as {app_name}-config.json or {app_name}-config.yaml.


JSON or YAML can also be Viewed, Edited, Copied, or Exported by selecting ACTIONS -> EDIT on an App and clicking the RAW section in the Edit App modal.


Provisioning Apps via API

A quick example of how this work: