terraform/website/source/docs/providers/vcd/r/vapp.html.markdown

---
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`