--- layout: "vcd" page_title: "vCloudDirector: vcd_vapp" sidebar_current: "docs-vcd-resource-vapp" description: |- Provides a vCloud Director vApp resource. This can be used to create, modify, and delete vApps. --- # vcd\_vapp Provides a vCloud Director vApp resource. This can be used to create, modify, and delete vApps. ## Example Usage ``` resource "vcd_network" "net" { # ... } resource "vcd_vapp" "web" { name = "web" catalog_name = "Boxes" template_name = "lampstack-1.10.1-ubuntu-10.04" memory = 2048 cpus = 1 network_name = "${vcd_network.net.name}" network_href = "${vcd_network.net.href}" ip = "10.10.104.160" metadata { role = "web" env = "staging" version = "v1" } } ``` ## Argument Reference The following arguments are supported: * `name` - (Required) A unique name for the vApp * `catalog_name` - (Required) The catalog name in which to find the given vApp Template * `template_name` - (Required) The name of the vApp Template to use * `memory` - (Optional) The amount of RAM (in MB) to allocate to the vApp * `cpus` - (Optional) The number of virtual CPUs to allocate to the vApp * `initscript` (Optional) A script to be run only on initial boot * `network_name` - (Required) Name of the network this vApp should join * `network_href` - (Optional) The vCloud Director generated href of the network this vApp should join. If empty it will use the network name and query vCloud Director to discover this * `ip` - (Optional) The IP to assign to this vApp. Must be an IP address or one of dhcp, allocated or none. If given the address must be within the `static_ip_pool` set for the network. If left blank, and the network has `dhcp_pool` set with at least one available IP then this will be set with DHCP. * `metadata` - (Optional) Key value map of metadata to assign to this vApp * `power_on` - (Optional) A boolean value stating if this vApp should be powered on. Default to `true`