Skip to content

Deploy on Proxmox Enterprise ​

Download the disk image ​

  1. Open Trapsters → click the + card → Deploy a new Trapster
  2. Click Proxmox VE : the qcow2 disk image downloads to your browser

The same qcow2 image works for KVM / libvirt deployments.

See Deployment overview for the full wizard flow.

1. Create a new VM ​

In the Proxmox web interface, create a new VM. The name has no impact on its network identity - you can use anything, for example trapster-1.

Click the Advanced button and check Start at boot.

proxmox step 1

2. OS ​

Select Do not use any media. The disk will be imported from the downloaded image.

proxmox step 2

3. System ​

Leave the default settings.

4. Disks ​

Delete the auto-created disk. The disk will be attached after image import.

5. CPU ​

Default settings are sufficient:

  • 1 socket
  • 1 core

6. Memory ​

Set to 2048 MB. Enable the Ballooning option to avoid reserving the full 2 GB at all times.

7. Network ​

Configure the VM to receive a local IP so the rest of your network can reach it. Default settings work for most configurations.

8. Confirm ​

Your VM configuration should look like this before starting:

proxmox step 3

Transfer the disk image to Proxmox ​

Send the downloaded image to your Proxmox server using scp:

bash
scp Trapster-<version>.assets root@your-proxmox:/var/lib/vz/template/iso/

Alternatively, rename the file to .assets and upload it through the Proxmox storage interface.

Ensure your storage supports disk uploads: go to Datacenter > Storage > local, click Edit and enable disk images.

proxmox step 4

Attach the disk to the VM ​

Import the disk to your VM. Note your VM ID and the image path, then run:

bash
qm importdisk 100 /var/lib/vz/template/iso/Trapster-<version>.assets local

Replace 100 with your VM ID.

In the Proxmox hardware view, double-click the Unused disk to attach it. Then go to Options > Boot Order: deselect all entries and select the imported disk.

Start the VM. It will boot and connect to your Trapster dashboard automatically.

9. Accept registration ​

After the Trapster boots, it appears as a pending device on the Trapsters page.

See Trapsters: accept registration.