import type { Metadata } from "next"
import { Steps } from "@/components/ui/steps"
export const metadata: Metadata = {
title: "Import Disk Image to a VM | ProxMenux Documentation",
description: "Learn how to import a disk image to a virtual machine in Proxmox VE.",
}
export default function ImportDiskImageVM() {
return (
Import Disk Image to a VM
This script automates the process of importing disk images into Proxmox VE virtual machines (VMs). It simplifies
the task of attaching pre-existing disk files to VMs without requiring manual configuration.
What Does This Script Do?
When executed, this script performs the following actions:
- Scans for compatible disk images (.img, .qcow2, .vmdk) in the /var/lib/vz/template/images/ directory
- Presents a list of available VMs for selection
- Allows you to choose one or multiple disk images for import
- Lets you select a storage volume in Proxmox for disk placement
- Offers options for interface type (SATA, SCSI, VirtIO, IDE) for each imported disk
- Provides optional settings like SSD emulation and bootable disk configuration
- Imports the selected disk images and attaches them to the chosen VM
Key Steps
Ensure that the disk images you want to import are placed in the /var/lib/vz/template/images/ directory.
Choose the VM where you want to import the disk image(s) from a list of available VMs.
Select the Proxmox storage volume where the imported disk(s) will be placed.
Choose one or more disk images to import from the list of compatible images found in the specified
directory.
For each selected image:
- Choose the interface type (SATA, SCSI, VirtIO, or IDE)
- Optionally enable SSD emulation (for non-VirtIO interfaces)
- Decide whether to make the disk bootable
The script will import each selected disk image, showing real-time progress updates.
After import, the script configures the disks in the VM and applies the chosen settings.
What to Expect
- The script will guide you through the process with clear prompts and menus.
- You'll need to make selections for the target VM, storage, disk images, and configuration options.
- The import process may take some time, depending on the size and number of disk images.
- Real-time progress updates will be displayed during the import process.
- After completion, the imported disks will be available and configured in the selected VM.
Important Notes
- Ensure you have sufficient storage space in the selected Proxmox storage volume before importing.
- The script supports .img, .qcow2, and .vmdk disk image formats.
- Make sure the VM is powered off before importing disk images to avoid potential conflicts.
-
Importing a disk as bootable will modify the VM's boot order. Adjust the boot order in the VM settings if
necessary.
- SSD emulation is only available for non-VirtIO interfaces (SATA, SCSI, IDE).
- This script requires root or sudo privileges to execute.
This script simplifies the process of importing disk images to VMs in Proxmox VE, making it easy to add
pre-existing disks or migrate disks from other environments. It handles the technical details of import and
configuration, allowing you to quickly add new storage to your VMs.
)
}