How to deploy a Domotz Agent Proxmox disk image onto a Proxmox Host
Installing a Domotz Agent on Proxmox. This article explains how to deploy a pre-configured VM image on a Proxmox Host.
Put Domotz VM dump file into your Proxmox host
1) Download the Proxmox dump from here:
- US Mirror: vzdump-qemu-domotz-agent-proxmox-2025_07_03.vma.gz
- EU Mirror: vzdump-qemu-domotz-agent-proxmox-2025_07_03.vma.gz
2) Upload the vma.gz on your Proxmox server using a file transfer protocol of your choice (scp, stp, ftp, etc.)
Import the dump in Proxmox
Login to your Proxmox host and become root:
sudo suGo inside the directory where the proxmox dump file resides and import it by choosing your Proxmox ID and the STORAGE_NAME
qmrestore vzdump-qemu-domotz-agent-proxmox-$date.vma.gz $ID –storage $STORAGE_NAMEFor example (ID = 127 and STORAGE_NAME = vms-storage)
qmrestore vzdump-qemu-domotz-agent-proxmox-2025_07_03.vma.gz 127 --storage vms-storage
Restoring a Virtual Machine Archive in Proxmox
1. Open a terminal with root access.
2. Run the command to restore the virtual machine archive: `qmrestore vzdump-qemu-d...vma.gz`.
3. Use options such as `--storage` to specify the target storage and provide the path to the backup `.vma.gz` file.
4. The system will process the archive and show a series of progress percentages indicating bytes read and the duration in seconds for each progress step.
5. Check for the final volume ID and map details, such as the format `qcow2` and cluster size, to ensure the configuration is correct.
6. Monitor progress until 100% completion to confirm that the restoration is successful.
Disk Cloning Progress and Summary
1. The cloning progress is at 99%, with 34,016,986,656 bytes read over 56 seconds.
2. Completion reaches 100%, with a total of 34,359,783,368 bytes read in the same duration.
3. The summary displays total bytes read, including 34,359,783,368 bytes with 28,703,260,672 bytes identified as sparse, accounting for 83.5%.
4. Space reduction due to 4K zero blocks is noted at 3.3%.
5. A prompt indicates rescanning of volumes.
Setting up its virtual nic in Bridge mode:
Accessing Network Device Settings for a Virtual Machine
1. In the Server View panel on the left, locate and select the virtual machine named "123 (domotz)" under the Datacenter section.
2. Navigate to the right panel and click on "Hardware" in the menu to access the hardware configuration options.
3. In the list of hardware components, find and select "Network Device (net0)" to view and manage the network settings for this virtual machine.
Please delete any MAC address you see in the screenshot below, leave it blank then click OK (a new MAC address will be generated).
Editing a Network Device Configuration
1. **Bridge Selection**: Use the dropdown menu to select the appropriate bridge, such as "vmbr0."
2. **Model Selection**: Choose the desired network model from the dropdown, such as "VirtIO (paravirtualized)."
3. **VLAN Tag**: Enter a VLAN tag if necessary.
4. **MAC Address**: Input a specific MAC address if required.
5. **Firewall Option**: Check the box to enable the firewall for this network device.
6. **Help and Advanced Options**: Use the "Help" button for assistance. Check the "Advanced" box to reveal additional settings.
7. **Confirm or Reset**: Click "OK" to save changes or "Reset" to discard them.
Then, please proceed with the following:
1) Start your Domotz virtual machine which is configured already to get an IP address from a DHCP server
2) Login ( user: domotz password: domotz) to get its IP address (or to set it if you need to change it).
3) Open a browser to http://$yourdomotzvmipaddress:3000
4) Activate your Domotz Agent
NOTE: When the Virtual Machine starts it will allocate a unique MAC Address for each Proxmox instance. Make sure to change the MAC Address of the bridge interface to something specific and different if required by your organization.
for security reasons please remember to:
1) change the default domotz user password
2) perform an apt update and an apt upgrade
Configuring VLANs in Proxmox VE
To configure VLANs for the Domotz Agent in Proxmox VE, please see here: https://pve.proxmox.com/wiki/Network_Configuration#sysadmin_network_vlan