Proxmox

Installing MikoPBX using Proxmox.

Loading the MikoPBX image

1. Open the local / ISO images tab and select Download from URL

2. In the URL field, paste the link to the MikoPBX distribution file with the .iso extension

3. Click the Download button and wait for the file to finish downloading

Loading the MikoPBX image

Creating a virtual machine

1. Select Create VM

2. On the General tab, enter the name of the virtual machine, for example mikopbx-vm

Configuring virtual machine

1. Go to the OS tab, and in the ISO image field, select the previously downloaded image

2. Set the OS type to Linux

Configuring virtual machine

1. On the System tab, uncheck the Qemu Agent box, and use the default values for other fields

Configuring virtual machine

To deploy the PBX use two disks:

• A 1 Gb disk for the main system

• A 50+ Gb disk for storing call recordings

1. Go to the Disks tab

2. Adjust the size of the system disk to 1 GB

Configuring virtual machine

1. Click the Add button and add an additional disk for data storage

2. Specify a disk size of at least 50 GB

Configuring virtual machine

1. On the CPU and Memory tabs, specify the computing resources for the virtual machine based on the expected load on the PBX. For a test machine, you can set Cores (CPU tab) to 2 and Memory (Memory tab) to 2 GB

Configuring virtual machine

Configuring virtual machine

1. On the Network tab, uncheck the Firewall box

Configuring virtual machine

1. Go to the last tab, Confirm, and check the Start after created box

2. After entering the values, click the Finish button

Configuring virtual machine

Installing MikoPBX

1. Go to the created virtual machine mikopbx-vm

2. On the open tab, go to the Console section

3. If the boot is successful, a console menu will appear. Enter 8 from the keyboard to start the installation

Installing MikoPBX

1. Select the disk for the system and enter the disk name from the keyboard, for example sda. Confirm the selection by entering y from the keyboard

Installing MikoPBX

Installing MikoPBX

1. Connect the disk for storing call recordings, enter the disk name for connection from the keyboard, for example sdb

Installing MikoPBX

When the message "Press any key within 30 seconds to boot from LiveCD..." appears, do not press any buttons. In this case, the system will boot from the hard drive.

Starting MikoPBX

1. To access the MikoPBX web interface, enter your virtual machine's IP address in your browser's address bar. You can find the IP address in the console.

MikoPBX IP-address

1. Enter the IP address in your browser’s address bar. Log in using the default credentials.

Use the following default credentials for the first login to the MikoPBX web interface:

• Username: admin

• Password: admin

MikoPBX WEB-interface authorization page

Enabling the QEMU Guest Agent

The QEMU Guest Agent lets Proxmox read the guest IP addresses from MikoPBX, perform a clean OS-level shutdown from the Shutdown button, and take consistent backups (fs-freeze). The qemu-ga binary is already shipped with MikoPBX and is automatically started by monit (the vm-tools service) — you only need to enable the agent channel on the Proxmox side.

1. Select the MikoPBX virtual machine, open the Options tab and double-click the QEMU Guest Agent row

2. Tick Use QEMU Guest Agent (set to Enabled), keep Type = VirtIO (default) and click OK

Enabling QEMU Guest Agent in VM Options

After enabling the option you must perform a full stop and start of the VM (Stop → Start in the WEB UI, or from the Proxmox CLI: qm stop <VMID> && qm start <VMID>).

A regular Reboot is not enough — the virtio-serial device that the agent talks through is attached to the QEMU process only on a cold start. Without that restart the /dev/virtio-ports/org.qemu.guest_agent.0 device never appears inside MikoPBX and the agent cannot start.

Verifying the QEMU Guest Agent

On the Proxmox host (quick alive/dead check):

qm agent <VMID> ping                       # should return an empty response with no error
qm agent <VMID> info                       # agent version and supported commands
qm guest cmd <VMID> get-host-name          # guest hostname — proves the agent actually replies
qm agent <VMID> network-get-interfaces     # guest IP addresses (also visible in the VM summary)

Inside MikoPBX (via SSH):

ls -la /dev/virtio-ports/org.qemu.guest_agent.0   # this file must exist
ps w | grep qemu-ga | grep -v grep                # the qemu-ga process must be running
monit summary | grep vm-tools                     # expected state: Running

If monit summary shows vm-tools Initializing and /dev/virtio-ports/org.qemu.guest_agent.0 is missing, the virtio-serial channel has not been attached to the VM yet — either the option is not enabled on the Proxmox side, or the VM has not been cold-restarted after enabling it.