Importing a VM
Bringing in a machine from VMware, Proxmox or a disk file: the original is only read, and the copy only starts when you say so.
Where to find it
On the Cloud page, Normal mode, Imports section (Imported VMs). The section only exists in zones whose hosts can convert machines: if you do not see it, your zone does not offer imports today.
From where
Press Import a VM and choose the source (From):
| Source | What you need |
|---|---|
| A file link | An https:// link, reachable from the internet, to an OVA, VMDK, qcow2, raw or VHDX file. A signed link to object storage works too |
| VMware | vCenter or ESXi, read directly: the name or public address, the name of the VM (stopped), for vCenter the ESXi host in the inventory (empty for a standalone ESXi), username and password. A read-only account is enough. The password is used once by the host doing the conversion, and is not stored anywhere |
| Proxmox | Proxmox has no API that hands out a disk: give a link to the disk (qcow2 or raw) or to an exported image |
| Upload a file | Not available yet |
Then: the new server's name, the size, the architecture, the disk (at least as large as the original disk; only the first disk is imported), the public address, the ports. Optionally, the SHA-256 of the file, checked after download. Review the plan, then Import.
The steps
| State | What happens | What you do |
|---|---|---|
| Importing | The host downloads, reads the disk, converts it (drivers, boot, removing the old hypervisor's tools) and writes it | Wait. You can close the window: the import carries on |
| Ready | The VM exists, stopped and without network | Read the preview: system, architecture, boot, disks, what was changed inside, warnings |
| Testing | Running, still without network | Look at it from the console. Button Start it, still disconnected |
| Connected | Connected to the network: from here on it is a server like any other | Connect it to the network |
| Failed | Something went wrong | Cancel import and try again. The original was never touched |
Cancel import deletes the new server and its disk; the source VM stays as it was.
For developers
Methods and tools with the same name: Cloud/importServer (cloud_import_server), Cloud/getImportList, Cloud/getImport (import_id), Cloud/startImport, Cloud/connectImport, Cloud/cancelImport. Fields of Cloud/importServer: name, size, disk_gb, source_type (url or vmware) required; for url: url, format (auto, ova, vmdk, qcow2, raw, vhdx), sha256; for vmware: vmware_server, vmware_path, vmware_vm, vmware_username, vmware_password, vmware_insecure; and then architecture (amd64, arm64), public_ip, public_ip_pool, open_ports, ports_source. Operator role; all writes accept dry_run.
From the AI mode assistant you can only import from a link: an import from VMware needs a password and is done from the panel.