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.