Vultr DocsLatest Content

How to Attach a VPC 2.0 Network to a Vultr Cloud Compute Instance

Updated on 11 September, 2025

A private network solution that allows you to securely connect multiple Vultr resources within an isolated environment.

A Virtual Private Cloud (VPC) 2.0 network creates a secure and isolated private networking interface to enable connections to other instances attached to the same network. You can attach multiple VPC 2.0 networks to enable secure connections between a Vultr Cloud Compute instance and other instances attached to the same VPC 2.0 network.

Follow this guide to attach a VPC 2.0 network to a Vultr Cloud Compute instance using the Vultr Customer Portal, API, CLI, or Terraform.

  • Vultr Customer Portal
  • Vultr API
  • Vultr CLI
  • Terraform
  1. Navigate to Products and click Compute.
  2. Click your target Vultr Cloud Compute instance to open its management page.
  3. Navigate to the Settings tab.
  4. Click VPC 2.0 on the left navigation menu.
  5. Click Enable VPC 2.0 to activate a new VPC 2.0 network interface.
  6. Click Enable VPC 2.0 in the confirmation prompt to apply the changes.
  7. Click the VPC 2.0 drop-down to select a specific network and click Attach to apply the changes on your instance.

  1. Send a GET request to the List Instances endpoint and note your target instance's ID.

    console 
    $ curl "https://api.vultr.com/v2/instances" \
  -X GET \
  -H "Authorization: Bearer ${VULTR_API_KEY}"

  2. Send a GET request to the List Instance VPC 2.0 Networks endpoint to list all VPC 2.0 networks in your Vultr account and note the target VPC 2.0 network's ID.

    console 
    $ curl "https://api.vultr.com/v2/vpc2" \
  -X GET \
  -H "Authorization: Bearer ${VULTR_API_KEY}"

  3. Send a POST request to the Attach VPC 2.0 to Instance endpoint to attach a VPC 2.0 network to the instance.

    console 
    $ curl "https://api.vultr.com/v2/instances/{instance-id}/vpc2/attach" \
  -X POST \
  -H "Authorization: Bearer ${VULTR_API_KEY}" \
  -H "Content-Type: application/json" \
  --data '{
    "vpc_id": "<vpc2-id>"
  }'

  1. List all available instances and note your target instance's ID.

    console 
    $ vultr-cli instance list

  2. List all available VPC 2.0 networks and note the target VPC 2.0 network ID.

    console 
    $ vultr-cli vpc2 list

  3. Attach the VPC 2.0 network to the instance.

    console 
    $ vultr-cli vpc2 nodes attach <vpc2-id> \
        --nodes="<instance-id>"

  1. Open your Terraform configuration for the existing Cloud Compute instance.

  2. Create (or reference) a VPC 2.0 network and attach it to the instance.

    terraform 
    # Create a new VPC 2.0 network
resource "vultr_vpc2" "private_net" {
    region      = "del"
    description = "Private network for CC workloads"
}

# Attach the VPC 2.0 network to the Cloud Compute instance
resource "vultr_instance" "cc" {
    # ...existing fields (region, plan, os_id, label, etc.)
    label     = "cc-instance-1"
    region    = "del"
    plan      = "vc2-2c-4gb"
    os_id     = 2284
    vpc2_ids  = [vultr_vpc2.private_net.id]
}

  3. Apply the configuration and observe the following output:

    Apply complete! Resources: 2 added, 0 changed, 0 destroyed.

Comments

No comments yet.