> 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/proxmox.md).

# Proxmox

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

### **Загрузка образа MikoPBX**

1. Откройте вкладку local / **ISO images** и выберите **Download from URL**
2. В поле URL вставьте ссылку на файл из дистрибутива MikoPBX с расширением **.iso**
3. Нажмите кнопку **Download**, дождитесь окончания загрузки файла

<figure><img src="/files/gecNLp1lNjHm2BYvYrzU" alt=""><figcaption></figcaption></figure>

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

1. Выберите **Create VM**
2. На вкладке General введите имя (Name) виртуальной машины, например *mikopbx-vm*

<figure><img src="/files/zPNzGxr9HjFKUo4HIUHl" alt=""><figcaption></figcaption></figure>

3. Перейдите к следующей вкладке OS, в поле ISO image выберите загруженный ранее образ
4. Укажите тип OS (Type) - **Linux**

<figure><img src="/files/8cbZZjYb6t4ieioTGkY3" alt=""><figcaption></figcaption></figure>

5. На вкладке System уберите флажок Qemu Agent, для других полей используйте значения по умолчанию

<figure><img src="/files/7PiNz58MUfTAxJRKEzNZ" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Для развертывания АТС используйте **два** диска:

* диск объемом **1 Гб** для основной системы
* диск объемом **50+ Гб** для хранения записей разговоров
  {% endhint %}

6. Перейдите к вкладке Disks
7. Скорректируйте размер диска под систему до **1 Гб**

<figure><img src="/files/7s4Ytbp1lxoTh3epA4n6" alt=""><figcaption></figcaption></figure>

8. Нажмите кнопку **Add** и добавьте дополнительный диск для хранения данных
9. Укажите размер диска не менее 50 Гб

<figure><img src="/files/YDZLjiusObeqxRGOdidH" alt=""><figcaption></figcaption></figure>

10. На вкладках CPU и Memory укажите параметры вычислительных ресурсов виртуальной машины, исходя из ожидаемой нагрузки на АТС. Для тестовой машины можно указать в поле Cores (вкладка CPU) - 2, в поле Memory (вкладка Memory) - 2 Гб

<figure><img src="/files/ttflXu1UUOjkxEuutTWS" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/C19T6w6K35nC3M8wH9SA" alt=""><figcaption></figcaption></figure>

11. На вкладке Network уберите флажок Firewall

<figure><img src="/files/NOWebtYRNU2nF4VWTeVY" alt=""><figcaption></figcaption></figure>

12. Перейдите к последней вкладке Confirm и установите флажок **Start after created**
13. Завершив ввод значений, нажмите кнопку **Finish**

<figure><img src="/files/LMCQldHDpzbwZt7c8E9J" alt=""><figcaption></figcaption></figure>

### **Установка АТС MikoPBX**

1. Перейдите к созданной виртуальной машине *mikopbx-vm*
2. На открытой вкладке перейдите в раздел Console
3. Если загрузка прошла успешно, появится консольное меню. Введите с клавиатуры **8** для начала установки

<figure><img src="/files/vNjCwL20pndAZ6LJkaSG" alt=""><figcaption></figcaption></figure>

4. Выберите диск под систему и введите с клавиатуры имя диска, например ***sda***. Подтвердите выбор, введите с клавиатуры ***y***

<figure><img src="/files/ZjqOhCFHaLqchbhyZcA2" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/9Arur6rYAQjbiv8SQT9g" alt=""><figcaption></figcaption></figure>

5. Подключите диск для хранения записей разговоров, ведите с клавиатуры наименование диска для подключения, например ***sdb***

<figure><img src="/files/TCwIhLZPGbpdPICNxaNu" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
После появления сообщения “**Press any key within 30 seconds to boot from LiveCD…**” не нажимайте никаких кнопок. В этом случае система загрузится с жесткого диска.
{% endhint %}

### **Запуск АТС MikoPBX**

1. На открытой вкладке в разделе Console скопируйте внешний адрес созданной виртуальной машины и введите его в строке браузера

<figure><img src="/files/JHOruZJQ0adXKqLplWRk" alt=""><figcaption></figcaption></figure>

2. Для входа используйте логин - admin и пароль - admin

<figure><img src="/files/PIdr2GW27jzu16i6QqIB" alt=""><figcaption></figcaption></figure>

### **Включение QEMU Guest Agent**

QEMU Guest Agent позволяет Proxmox получать от MikoPBX внутренние IP-адреса, корректно завершать работу гостя по команде Shutdown и снимать консистентные бэкапы (fs-freeze). Сам бинарь `qemu-ga` уже включён в дистрибутив MikoPBX и автоматически запускается под управлением `monit` (сервис `vm-tools`) — нужно только включить канал агента на стороне Proxmox.

1. Выберите виртуальную машину MikoPBX, откройте вкладку **Options** и сделайте двойной клик по строке **QEMU Guest Agent**
2. Установите флажок **Use QEMU Guest Agent** (значение **Enabled**), параметр **Type** оставьте **VirtIO** (по умолчанию), нажмите **OK**

<figure><img src="/files/CdI4uxWwfahF3IAnN82V" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
После включения опции необходимо выполнить **полную остановку и повторный запуск** виртуальной машины (**Stop → Start** в WEB-интерфейсе или из CLI Proxmox: `qm stop <VMID> && qm start <VMID>`).

Обычная перезагрузка (**Reboot**) **не подходит** — устройство `virtio-serial`, через которое работает агент, добавляется в процесс QEMU только при холодном старте. Без рестарта внутри MikoPBX не появится файл `/dev/virtio-ports/org.qemu.guest_agent.0` и агент стартовать не сможет.
{% endhint %}

### **Проверка работы QEMU Guest Agent**

**На хосте Proxmox** (быстрая проверка «жив/мёртв»):

```bash
qm agent <VMID> ping                       # должно вернуть пустой ответ без ошибки
qm agent <VMID> info                       # версия агента и список поддерживаемых команд
qm guest cmd <VMID> get-host-name          # hostname гостя — подтверждает реальный ответ
qm agent <VMID> network-get-interfaces     # IP-адреса гостя (видны в WEB-интерфейсе VM)
```

**Внутри MikoPBX** (по SSH):

```sh
ls -la /dev/virtio-ports/org.qemu.guest_agent.0   # файл должен существовать
ps w | grep qemu-ga | grep -v grep                # процесс qemu-ga должен быть запущен
monit summary | grep vm-tools                     # ожидаемое состояние: Running
```

Если `monit summary` показывает `vm-tools Initializing`, а файл `/dev/virtio-ports/org.qemu.guest_agent.0` отсутствует — значит со стороны Proxmox virtio-serial-канал ещё не проброшен в VM (опция не включена либо машина не была холодно перезапущена).


---

# 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/proxmox.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.