# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mikopbx.com/mikopbx/english/setup/hypervisor/utm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
