Skip to main content

Add Image to tiCrypt

Last updated: May 31, 2026Latest Frontend Version: 2.17.0

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 whatever 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 are visible to hardware profiles and VM configurations. If you do not create a VM Image record, the Libvirt volume cannot be used to build VMs.

4. Create or Update a Hardware Profile

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

note

Updating an existing hardware profile does not affect running VMs until they are rebooted.