# UTM

{% embed url="<https://youtu.be/p2acynLM5aI>" %}

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](https://github.com/mikopbx/core/releases).&#x20;

{% hint style="info" %}
This instruction has been relevant since the first release, published in 2026. Tested on Apple Silicon processors.
{% endhint %}

## Creating a virtual machine

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FgkpQo9XLvocSjWL3JQvz%2FUTMDashboard.png?alt=media&#x26;token=2f5149a2-f2e0-4eb9-8332-e2217c0cc897" alt=""><figcaption><p>The main page of UTM. Creating a new VM.</p></figcaption></figure>

2. Select "Virtualize" as the VM type.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FXhvQQuwKsV80WCeCo6i0%2FchooseTypeOfGuestM.png?alt=media&#x26;token=b902207f-09cf-41d6-a206-3546ec324d82" alt=""><figcaption><p>Selecting the type of virtual machine</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FemA0lEdqxx3lhXYNAoRX%2FchooseOS.png?alt=media&#x26;token=1fc757c6-c164-4237-95b8-a90f894151fd" alt=""><figcaption><p>Choosing the type of operating system</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FoWuKMSOrqmO2Bd9u9p5y%2FchooseAnImage.png?alt=media&#x26;token=e19f85fe-6ce5-489d-87bd-422f62cb631a" alt=""><figcaption><p>Selecting a disk image file for a VM</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FLItxyUcEkLWC58UTWhlD%2FsetHardware.png?alt=media&#x26;token=f10aa38d-1fd1-4801-a5dd-ad0586a790cb" alt=""><figcaption><p>VM Configuration</p></figcaption></figure>

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

{% hint style="info" %}
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.
   {% endhint %}

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FpEtUcISS1jsxWRGn3Acc%2FsetStorage.png?alt=media&#x26;token=3a990a7c-cbb8-4a5f-8f90-996c0d87062c" alt=""><figcaption><p>Specifying the size of the system disk</p></figcaption></figure>

7. Click Continue.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fn2fxiaiLTYY4pa6qd37N%2FsetSharedDirectory.png?alt=media&#x26;token=7ac867d5-f978-48c9-8444-bedff7f9922b" alt=""><figcaption><p>The "Shared Directory" section</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FLNW7rEixkwxFDEM0AxGz%2FguestMachineSummary.png?alt=media&#x26;token=43c27c91-c03f-4840-921e-3147099b3fb1" alt=""><figcaption><p>The final configuration</p></figcaption></figure>

## Connecting a disk for data storage

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FsWo0pQT1YR6NbDzTcyHs%2FVMGoToSettings.png?alt=media&#x26;token=5134f2d8-cc6a-45d2-8a0e-c8d317eeaf00" alt=""><figcaption><p>VM Settings</p></figcaption></figure>

2. Go to "Drives". Click "New\..."

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FHxxeu3o97Pzx7iQETBPx%2FaddingNewDisk(Ch1).png?alt=media&#x26;token=2cb98207-ed29-4242-998a-c09841a37d3e" alt=""><figcaption><p>"Drives" section</p></figcaption></figure>

3. 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".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fa2zdzG45ROk1jGhpIDyv%2FaddingNewDisk(Ch2).png?alt=media&#x26;token=ca5b3347-66c6-4bbe-8747-09722b199282" alt=""><figcaption><p>Creating a second disk</p></figcaption></figure>

## System installation

1. Start the VM.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F4hA1Y0q0yu4h7pLoziUr%2FUTMDashboardStartVM.png?alt=media&#x26;token=5eedea89-f237-4873-9538-8e22a343c8e6" alt=""><figcaption><p>Launching a VM</p></figcaption></figure>

2. After loading, you will see the message <mark style="color:red;">PBX is running in Live or Recovery mode</mark>. 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.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fedi2dF33INE9Yp6VGSsz%2FPBBRunningLiveCD.png?alt=media&#x26;token=d3825cb8-eddf-469a-8a15-27a9d4cbd385" alt=""><figcaption><p>MikoPBX in LiveCD mode</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FmL44lm0PJXGAPahzPxda%2FConnectingSystemDisk(Ch1).png?alt=media&#x26;token=e683365a-a92a-4391-86e4-3b7fb7f0261b" alt=""><figcaption><p>Selecting a disk to install the system on</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FlhC7MnEyLyYePk9ifjhd%2FConnectingSystemDisk(Ch2).png?alt=media&#x26;token=6e1a45e6-f6e4-4b96-9ad6-6adf149e3f5e" alt=""><figcaption><p>Confirming the disk selection</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FKCzANG0NLC2XVxgLyi1b%2FConnectingStorageDisk.png?alt=media&#x26;token=be0e257c-ccd6-4423-bb08-be8f0caa38bc" alt=""><figcaption><p>Selecting a disk for storing conversation recordings</p></figcaption></figure>

After that, the system will reboot and be available in normal mode (the label "<mark style="color:red;">PBX is running in Live or Recovery mode</mark>" will disappear).

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FOmszAsF8hVqPS8ztPuC5%2FPBXReady.png?alt=media&#x26;token=0f1f5e92-3e1e-4a13-b700-8d0ab5e30fda" alt=""><figcaption><p>MikoPBX IP-address</p></figcaption></figure>

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

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fft4wrUas8eBnMawUSFZy%2FWEBLoginForm.png?alt=media&#x26;token=91c78198-8e97-4cac-aec8-be597f255fe0" alt=""><figcaption><p>MikoPBX Web-interface</p></figcaption></figure>

{% hint style="info" %}
Standard login information:

* Login: admin
* Password: admin
  {% endhint %}