Trapster Documentation

Appearance

Deploy on KVM / Xen Enterprise ​

The Trapster image is distributed as a qcow2 disk image, which is natively compatible with both KVM/libvirt and Xen. The process below covers KVM; for Xen, import the same qcow2 image via xl or your management tool of choice.

Prerequisites ​

  • KVM and libvirt installed (qemu-kvm, libvirt-daemon, virt-manager)
  • qemu-img available

1. Download the image ​

Download the qcow2 disk image from the dashboard:

  1. Open Trapsters → click the + card → Deploy a new Trapster
  2. Click Proxmox VE : the qcow2 file is the same image used for KVM and Xen

See Deploy on Proxmox or Deployment overview.

2. Create the VM ​

Using virt-install:

bash
virt-install \
 --name trapster-1 \
 --memory 2048 \
 --vcpus 1 \
 --disk path=/var/lib/libvirt/images/trapster.qcow2,format=qcow2 \
 --import \
 --os-variant ubuntu22.04 \
 --network bridge=virbr0 \
 --noautoconsole

Adjust --network to match your bridge or network interface.

3. Start the VM ​

bash
virsh start trapster-1

The VM will boot and connect to your Trapster dashboard automatically.

4. Accept registration ​

After the Trapster boots, it appears as a pending device on the Trapsters page. Click Accept to register it.

See Trapsters: accept registration.

Next steps ​