Vultr DocsLatest Content

How to Attach VPC Networks on a Vultr Bare Metal Instance

Updated on 28 August, 2025

A Virtual Private Cloud (VPC) network enables a secure and isolated private networking interface on your instance for communication with other instances in the same network. You can attach multiple VPC networks to enable communication between an instance and other nodes attached to the same network.

Follow this guide to attach VPC networks on a Vultr Bare Metal 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 instance to open its management page.
  3. Navigate to the Settings tab.
  4. Click IPv4 on the left navigation menu.
  5. Click Enable VPC to attach a new VPC network to your instance.
  6. Click Enable VPC in the confirmation prompt to apply changes.
  7. Click Attach VPC in the confirmation prompt to apply changes to your instance.

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

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

  2. Send a GET request to the List VPCs endpoint to list all VPCs in your Vultr account and note the target VPC network's 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 Bare Metal 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 Bare Metal instances in your Vultr account and note the target instance's ID.

    console 
    $ vultr-cli bare-metal list

  2. List all VPC networks in your Vultr account and note the target VPC network's ID.

    console 
    $ vultr-cli vpc list

  3. Attach the VPC network to the instance.

    console 
    $ vultr-cli instance vpc attach <instanceID> --vpc-id="<vpc-id>"

  1. Open your Terraform configuration for the existing Bare Metal instance.

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

    terraform 
    # Create a new VPC network
resource "vultr_vpc" "private_net" {
    region      = "del"
    description = "Private network for Bare Metal workloads"
}

# Attach the VPC network to the Bare Metal instance
resource "vultr_bare_metal_server" "bm1" {
    # ...existing fields (region, plan, os_id, label, etc.)

    vpc_ids = [vultr_vpc.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.