Vultr DocsLatest Content

How to Attach Reserved IPs to a Vultr Instance

Updated on 12 September, 2025

A storage volume that can be mounted to a Vultr instance to provide additional disk space.

Attaching a reserved IP to an instance enables a new public network address on the instance's main network interface. You can attach multiple reserved IPs on an instance to enable fast resolution and system management.

Follow this guide to attach reserved IPs to a Vultr instance using the Vultr Customer Portal, API, CLI, or Terraform.

  • Vultr Customer Portal
  • Vultr API
  • Vultr CLI
  • Terraform
  1. Navigate to Products, expand the Network drop-down and select Reserved IPs from the list of options.
  2. Click your target reserved IP to open its management page.
  3. Click the Attach to Server drop-down, select your target instance and click Attach.
  4. Click Attach Reserved IP in the confirmation prompt to apply the reserved IP to your instance.

  1. Send a GET request to the List Reserved IPs endpoint and note the target reserved IP's ID.

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

  2. Send a GET request to the List Instances endpoint and note the target instance ID.

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

  3. Send a POST request to the Attach Reserved IP endpoint to attach the reserved IP to the instance.

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

  1. List all active reserved IPs in your Vultr account and note the target reserved IP ID.

    console 
    $ vultr-cli reserved-ip list

  2. List all instances in your Vultr account and note the target instance ID.

    console 
    $ vultr-cli instance list

  3. Attach the reserved IP to the instance.

    console 
    $ vultr-cli reserved-ip attach <reserved-ip-id> --instance-id="<target-instance-id>"

  1. Open your Terraform configuration for the existing instance and reserved IP.

  2. Set instance_id on the vultr_reserved_ip to attach, then apply.

    terraform 
    resource "vultr_instance" "server" {
    # ...existing fields
}

resource "vultr_reserved_ip" "rip" {
    region      = "ewr"
    ip_type     = "v4"
    label       = "web-rip"
    instance_id = vultr_instance.server.id
}

  3. Apply the configuration and observe:

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

Comments

O
oceanjeremy07:52 - 20 July, 2025

This simply does not work... it says “Attached to server” but doesn’t give an option to detach from that server nor to attach to a new server.

How can your documentation be so off from the actual user experience?

Showing 1 of 1 comments