> For the complete documentation index, see [llms.txt](https://docs.mikopbx.com/mikopbx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mikopbx.com/mikopbx/setup/hypervisor/utm.md).

# UTM

{% embed url="<https://vkvideo.ru/video-100268702_456239065>" %}

В данной иснтрукции будет произведена установка на UTM. Перед ее началом скачайте файл образа диска с расширением ".iso". Сделать это можно [по ссылке](https://github.com/mikopbx/core/releases).

{% hint style="info" %}
Данная инструкция актуальна с первого релиза, опубликованного в 2026 году. Протестированно на процессорах Apple Silicon.
{% endhint %}

## Создание виртуальной машины

1. Перейдите в UTM. Нажмите "Create a New Virtual Machine" для создания новой виртуальной машины.

<figure><img src="/files/ccR5lQvKYcth8huLym9n" alt=""><figcaption><p>Главная страница UTM. Создание новой виртуальной машины.</p></figcaption></figure>

2. В качестве типа виртуальной машины выберите "Virtualize".

<figure><img src="/files/BzGprabhICnQrVBan7GN" alt=""><figcaption><p>Выбор типа виртуальной машины</p></figcaption></figure>

3. В качестве типа операционной системы выберите "Preconfigured" - "Linux".

<figure><img src="/files/gfVHCOPhChQeKVhyCT9G" alt=""><figcaption><p>Выбор типа операционной системы</p></figcaption></figure>

4. Выберите ранее загруженный файл образа диска в разделе "Boot ISO Image". Для этого нажмите на "Browse...".

<figure><img src="/files/7psFUrMkawkRs0GwI5rf" alt=""><figcaption><p>Выбор файла образа диска для виртуальной машины</p></figcaption></figure>

5. Далее укажите характеристики Вашей виртуальной машины. В нашем случае будут использованы 2 ГБ ОЗУ и 2 ядра процессора.

<figure><img src="/files/4dXvWUdN3bKIoZgNvA0j" alt=""><figcaption><p>Конфигурация ВМ</p></figcaption></figure>

6. Далее укажите размер для системного диска. В нашем случае - 1 Гб.

{% hint style="info" %}
В MikoPBX используются два диска:

1. Системный диск. На него устанавливается система, рекомендуемый размер - 1 Гб.
2. Диск для хранения записей разговоров. Рекомендуемый размер - от 50 Гб.
   {% endhint %}

<figure><img src="/files/wwyWunuGpTPjE5crBiTk" alt=""><figcaption><p>Указание размера системного диска</p></figcaption></figure>

7. Нажмите Continue.

<figure><img src="/files/LBwlnxTGdUGfO5T0dKGj" alt=""><figcaption><p>Раздел "Shared Directory"</p></figcaption></figure>

8. Будет отображена итоговая конфигурация виртуальной машины. Задайте ей желаемое имя (поле "Name"). И нажмите "Save".

<figure><img src="/files/SNbRtX4XSbDMeuVEWoEL" alt=""><figcaption><p>Итоговая конфигурация</p></figcaption></figure>

## Подключение диска для хранения данных

1. Перейдите в настройки ВМ. Для этого нажмите правой кнопкой мыши по её названию, далее "Edit".

<figure><img src="/files/mrbDilLPlScO0jqqkQw8" alt=""><figcaption><p>Настройки ВМ</p></figcaption></figure>

2. Перейдите в "Drives". Нажмите "New\..."

<figure><img src="/files/zEkYnYDZIKE1BCZGl2wd" alt=""><figcaption><p>Раздел "Drives"</p></figcaption></figure>

3. Создайте новый диск со следующими параметрами:

* **Interface** - VirtlO
* **Size** - не менее 50Гб (в этой документации для тестовой машины будет использовано 10Гб)

Нажмите "Create".

<figure><img src="/files/82d19JZKL7hfVnU597fW" alt=""><figcaption><p>Создание второго диска</p></figcaption></figure>

## Установка системы

1. Запустите виртуальную машину.

<figure><img src="/files/DRREJKBlNIF0s92cV7xF" alt=""><figcaption><p>Запуск ВМ</p></figcaption></figure>

2. После загрузки Вы увидите надпись <mark style="color:red;">PBX is running in Live or Recovery mode</mark>. Это означает, что система загружена из образа диска в Live режиме. Необходимо произвести установку системы. Для этого перейдите к разделу "\[8] Install on Hard Drive".

<figure><img src="/files/U3zYEtxLkuymH8ktz679" alt=""><figcaption><p>MikoPBX в режиме LiveCD</p></figcaption></figure>

3. Выберите диск для установки системы. В нашем случае доступны диски vda и vdb, для установки выбираем диск vda.

<figure><img src="/files/EWfIX03FV42Ti6j07Oc8" alt=""><figcaption><p>Выбор диска для установки системы</p></figcaption></figure>

4. Подтвердите выбор: введите "y" с клавиатуры и нажмите Enter.

<figure><img src="/files/5Y2nkGOcSOZFO2mX5sMm" alt=""><figcaption><p>Подтверждение выбора диска</p></figcaption></figure>

5. Далее выберите диск для хранения записей разговоров. В нашем случае единственный оставшийся размером 10 Гб.

<figure><img src="/files/PFhBlh9j177rzZI8cwhB" alt=""><figcaption><p>Выбор диска для хранения записей разговоров</p></figcaption></figure>

После этого система будет перезагружена и доступна в обычном режиме (надпись "<mark style="color:red;">PBX is running in Live or Recovery mode</mark>" пропадет).

<figure><img src="/files/ifpk2JeEp0gj9jmQ8Ols" alt=""><figcaption><p>IP-адрес MikoPBX</p></figcaption></figure>

Введите этот IP-адрес в строку браузера для перехода в Веб-интерфейс.

<figure><img src="/files/nVLth3GTa2tjpBFL9rII" alt=""><figcaption><p>Web-интерфейс MikoPBX</p></figcaption></figure>

{% hint style="info" %}
Стандартные данные для входа:

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.