Stay organized with collections
Save and categorize content based on your preferences.
NAME
gdcloud compute images import - Import a virtual machine image.
SYNOPSIS
gdcloud compute images import IMAGE_NAME [flags]
EXAMPLES
To import an Ubuntu 20.04 image, run:
gdcloud compute images import byo-ubuntu-2004 \
--project example-project \
--source-file=./ubuntu-image.img \
--os=ubuntu-2004
OPTIONAL FLAGS
--os string The OS of the disk image being imported. OS must be one of: "ubuntu-2004", "ubuntu-2204", "ubuntu-2404", "rhel-8", "windows-2019", "windows-10", "garden-linux", "suse-chost-15".
--source-file string A local disk image file to import.
--timeout string Maximum time an import can last before it fails as timeout. Default value is "1h". Max value is "24h". (default "1h")
GDCLOUD WIDE FLAGS
These flags are available to all commands: --configuration, --format, --help, --project, --quiet.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThis command imports a virtual machine image into the system using the \u003ccode\u003egdcloud compute images import\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eThe command requires the image name and allows specifying the source file and the operating system of the image being imported with the \u003ccode\u003e--source-file\u003c/code\u003e and \u003ccode\u003e--os\u003c/code\u003e flags.\u003c/p\u003e\n"],["\u003cp\u003eSupported operating systems include Ubuntu, RHEL, Windows, Garden Linux, and SUSE.\u003c/p\u003e\n"],["\u003cp\u003eThe maximum allowed timeout for an import is 24 hours, and it defaults to 1 hour using the \u003ccode\u003e--timeout\u003c/code\u003e flag.\u003c/p\u003e\n"],["\u003cp\u003eGlobal flags, like \u003ccode\u003e--project\u003c/code\u003e, \u003ccode\u003e--format\u003c/code\u003e, and \u003ccode\u003e--help\u003c/code\u003e, are available for use with this command.\u003c/p\u003e\n"]]],[],null,["# gdcloud compute images import\n\nNAME\n----\n\ngdcloud compute images import - Import a virtual machine image.\n\nSYNOPSIS\n--------\n\n gdcloud compute images import IMAGE_NAME [flags]\n\n### EXAMPLES\n\n To import an Ubuntu 20.04 image, run:\n\n gdcloud compute images import byo-ubuntu-2004 \\\n --project example-project \\\n --source-file=./ubuntu-image.img \\\n --os=ubuntu-2004\n\n### OPTIONAL FLAGS\n\n --os string The OS of the disk image being imported. OS must be one of: \"ubuntu-2004\", \"ubuntu-2204\", \"ubuntu-2404\", \"rhel-8\", \"windows-2019\", \"windows-10\", \"garden-linux\", \"suse-chost-15\".\n --source-file string A local disk image file to import.\n --timeout string Maximum time an import can last before it fails as timeout. Default value is \"1h\". Max value is \"24h\". (default \"1h\")\n\n### GDCLOUD WIDE FLAGS\n\nThese flags are available to all commands: `--configuration`, `--format`, `--help`, `--project`, `--quiet`.\n\nFor more information, see the [gdcloud CLI reference overview](/distributed-cloud/hosted/docs/latest/gdch/resources/gdcloud-reference/gdcloud) page."]]