UTM

Installing MikoPBX in UTM

In this manual, the installation will be performed on UTM. Before it starts, download the disk image file with the ".iso" extension. You can do this by following this link.

This instruction has been relevant since the first release, published in 2026. Tested on Apple Silicon processors.

Creating a virtual machine

1. Go to UTM. Click "Create a New Virtual Machine" to create a new virtual machine.

The main page of UTM. Creating a new VM.

1. Select "Virtualize" as the VM type.

Selecting the type of virtual machine

1. Select "Preconfigured" - "Linux" as the operating system type.

Choosing the type of operating system

1. Select the previously downloaded disk image file in the "Boot ISO Image" section. To do this, click on "Browse...".

Selecting a disk image file for a VM

1. Next, specify the characteristics of your virtual machine. In our case, 2 GB of RAM and 2 processor cores will be used.

VM Configuration

1. Next, specify the size for the system disk. In our case, 1 GB.

MikoPBX uses two disks:

1. The system disk. The system is installed on it, the recommended size is 1 GB.

2. A disk for storing recordings of conversations. The recommended size is from 50 GB.

Specifying the size of the system disk

1. Click Continue.

The "Shared Directory" section

1. The final configuration of the VM will be displayed. Give it the desired name (the "Name" field). And click "Save".

The final configuration

Connecting a disk for data storage

1. Go to the VM settings. To do this, right-click on its name, then "Edit".

VM Settings

1. Go to "Drives". Click "New..."

"Drives" section

1. Create a new disk with the following parameters:

• Interface - VirtlO

• Size - at least 50 GB (in this documentation, 10 GB will be used for the test machine)

Click "Create".

Creating a second disk

System installation

1. Start the VM.

Launching a VM

1. After loading, you will see the message PBX is running in Live or Recovery mode. This means that the system is loaded from the disk image in Live mode. It is necessary to install the system. To do this, go to the "[8] Install on Hard Drive" section.

MikoPBX in LiveCD mode

1. Select the disk to install the system. In our case, vda and vdb disks are available, and we select the vda disk for installation.

Selecting a disk to install the system on

1. Confirm the selection: enter "y" from the keyboard and press Enter.

Confirming the disk selection

1. Next, select a disk for storing conversation recordings. In our case, the only remaining one is 10 GB size disk.

Selecting a disk for storing conversation recordings

After that, the system will reboot and be available in normal mode (the label "PBX is running in Live or Recovery mode" will disappear).

MikoPBX IP-address

Enter this IP address in the browser bar to access the Web interface.

MikoPBX Web-interface

Standard login information:

• Login: admin

• Password: admin