Vultr DocsLatest Content

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

Updated on 10 September, 2025

A private network solution that allows secure communication between Vultr instances without using public internet connections.

A Virtual Private Cloud (VPC) 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 Optimized Cloud Compute instance and other instances attached to the same VPC network.

Follow this guide to attach a VPC network to a Vultr Optimized 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 Optimized Cloud Compute instance to open its management page.
  3. Navigate to the Settings tab.
  4. Click IPv4 on the left navigation menu.
  5. Click Enable VPC.
  6. Click Enable VPC in the confirmation prompt to apply the changes.
  7. Click Attach VPC in the confirmation prompt to apply changes to 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 VPCs endpoint to list all available VPCs and note the target VPC network ID.

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

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

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

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

    console 
    $ vultr-cli instance list

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

    console 
    $ vultr-cli vpc list

  3. Attach the VPC network to the instance.

    console 
    $ vultr-cli instance vpc attach <instance-id> <vpc-id>

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

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

    terraform 
    # Create a VPC network
resource "vultr_vpc" "app_net" {
    region      = "del"
    description = "Private network for OCC workloads"
}

# Attach the VPC network to the Optimized Cloud Compute instance
resource "vultr_instance" "occ" {
    label    = "occ-01"
    region   = "del"
    plan     = "vhp-2c-4gb"
    os_id    = 2284
    hostname = "occ-01"

    vpc_ids = [vultr_vpc.app_net.id]
}

  3. Apply the configuration and observe the following output:

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

Comments

No comments yet.