Add ARM Mac installation

installation/index.rst

@@ -5,8 +5,17 @@
 с использованием готового виртуального образа.
 
 Платформа распространяется в виде подготовленной виртуальной машины,
-которую необходимо импортировать в Oracle VirtualBox.
+которую необходимо импортировать в систему виртуализации.
 
+Поддерживаются два сценария установки:
+
+* Через Oracle VirtualBox (Windows / Linux / macOS Intel)
+* Через UTM (macOS Apple Silicon — M1/M2/M3)
+
+
+====================================================================
+Установка через Oracle VirtualBox
+====================================================================
 
 Предварительные требования
 ---------------------------
@@ -68,4 +77,147 @@
 
 Обычно запуск приложения занимает от 5 до 10 минут.
 После этого платформу можно открыть в браузере,
-используя указанные адреса.
+используя указанные адреса.
\ No newline at end of file
+
+
+====================================================================
+Установка на macOS (Apple Silicon / ARM)
+====================================================================
+
+Для компьютеров Mac с процессорами M1/M2/M3 используется приложение UTM.
+
+
+Предварительные требования
+---------------------------
+
+* macOS актуальной версии
+* минимум 8 ГБ RAM
+* свободное место на диске (15+ ГБ)
+
+
+Шаг 1. Установка UTM
+---------------------
+
+1. Перейдите на сайт:
+
+   https://mac.getutm.app/
+
+2. Скачайте и установите приложение.
+
+
+Шаг 2. Загрузка ARM-образа Synergy
+-----------------------------------
+
+Скачайте образ:
+
+https://releases.arta.pro/files/Arta-Synergy.qcow2
+
+
+Шаг 3. Создание виртуальной машины
+-----------------------------------
+
+1. В UTM нажмите **«Создать новую ВМ»**.
+
+2. Выберите режим **«Эмулировать»**.
+
+.. figure:: ../resources/img/emulate.jpg
+
+   Режим эмуляции
+
+3. Выберите **Linux**.
+
+.. figure:: ../resources/img/Linux.jpg
+
+   Выбор ОС
+
+4. Укажите ресурсы:
+
+   * RAM — 4096 MB
+   * CPU — 2 ядра
+
+.. figure:: ../resources/img/resources.jpg
+
+   Настройка ресурсов
+
+5. Выберите:
+
+   **Import existing drive**
+
+   И укажите файл ``Arta-Synergy.qcow2``.
+
+.. figure:: ../resources/img/import.jpg
+
+   Импорт существующего диска
+
+Сохраните виртуальную машину.
+
+
+Дополнительная настройка
+--------------------------
+
+Откройте настройки виртуальной машины.
+
+
+QEMU
+~~~~
+
+* Отключите **UEFI загрузку**
+
+.. figure:: ../resources/img/qemu.jpg
+
+   Настройки QEMU
+
+
+Дисплей
+~~~~~~~
+
+* Выберите видеокарту **virtio-vga**
+
+.. figure:: ../resources/img/display.jpg
+
+   Настройки дисплея
+
+
+Сеть
+~~~~
+
+1. Выберите режим **Эмулированный VLAN**
+2. Перейдите в раздел «Перенаправление»
+3. Добавьте правило:
+
+   * TCP
+   * Порт гостя — 8080
+   * Порт хоста — 8080
+
+.. figure:: ../resources/img/network.jpg
+
+   Настройка сети
+
+.. figure:: ../resources/img/port.jpg
+
+   Проброс портов
+
+
+Диск
+~~~~
+
+* Интерфейс — **IDE** или **SATA**
+
+.. figure:: ../resources/img/port.jpg
+
+   Настройки диска
+
+
+Запуск Synergy
+---------------
+
+1. Выберите виртуальную машину.
+2. Нажмите **«Запустить»**.
+
+После загрузки откройте в браузере:
+
+* http://localhost:8080/Synergy
+* http://localhost:8080/Configurator
+* http://localhost:8080/SynergyAdmin
+
+Первый запуск может занять от 5 до 10 минут.
\ No newline at end of file