Skip to main content
tiCrypt 2.18.1

Add Image to tiCrypt

Once your VM image is built (Linux or Windows), it must be placed into a Libvirt storage pool and registered in the tiCrypt frontend.

note

These operations require root access to the VM hosts.

1. Find the Storage Pool Path​

The image must be placed in the ticrypt-bricks pool. Locate its path:

virsh pool-dumpxml ticrypt-bricks | grep -i path

Example output:

<path>/ticrypt/libvirt/pools/ticrypt-bricks</path>

Use the path your environment returns in the steps below.

2. Copy and Activate the Image​

cp MyImage.qcow2 /ticrypt/libvirt/pools/ticrypt-bricks/
virsh pool-refresh ticrypt-bricks

Verify the image is visible:

virsh vol-list ticrypt-bricks | grep MyImage

To list all images in the pool:

virsh vol-list ticrypt-bricks

3. Register in the tiCrypt Frontend​

  1. Navigate to Management and open the Virtual Machines section.
  2. Under Libvirt Volumes, confirm the new image appears (refresh the list if needed).
  3. Go to VM Images and create a new VM Image pointing to the Libvirt Volume. Provide the name, operating system, supported drive formats, BUS type, and boot options.
caution

Only VM Images can be selected in a VM hardware setup, and VM configurations are built from hardware setups. If you do not create a VM Image record, the Libvirt volume cannot be used to build VMs.

4. Create or Update a VM Hardware Setup​

Once the VM Image exists in tiCrypt, it becomes available as a choice when creating or updating a VM hardware setup under VM Hardware Setups. See VM Hardware Setups.

note

Updating an existing hardware setup does not affect running VMs until they are restarted.