Vultr DocsLatest Articles

How to Change the Operating System on a Vultr Cloud Compute Instance

Updated on January 15, 2025

Changing the instance operating system wipes all data on your server and installs a new file system. This is important when changing the default operating system while preserving the instance's IP and networking information.

Follow this guide to change the operating system on a Vultr Cloud Compute instance using the Vultr Customer Portal, API, or CLI.

Warning
Changing to a different operating system wipes all the data on your server.
  • Vultr Customer Portal
  • Vultr API
  • Vultr CLI

  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. Find and click Change OS on the left navigation menu.

  5. Click the Choose new OS drop-down and select a new operating system to install on the instance.

  6. Click Change OS to change the instance operating system.

  7. Check the Change OS confirmation prompt and click Change OS to apply the new instance changes.

    Apply the new instance OS

  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 OS endpoint to view all available operating systems and note the target OS ID.

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

  3. Send a PATCH request to the Update Instance endpoint with a new os_id value to change the instance's operating system.

    console 
    $ curl "https://api.vultr.com/v2/instances/{instance-id}" \
-X PATCH \
-H "Authorization: Bearer ${VULTR_API_KEY}" \
-H "Content-Type: application/json" \
--data '{
  "os_id" : "new-instance-os_id"
}'

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

    console 
    $ vultr-cli instance list

  2. List all available operating systems and note the target OS ID.

    console 
    $ vultr-cli instance os list <instance-id>

  3. Change the target instance's operating system.

    console 
    $ vultr-cli instance os change <instance-id> --os <os_id>