> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS

> Запуск локального экземпляра Ayakaleaf Pro в macOS с помощью Docker Desktop и Toolkit.

В этом разделе мы запустим Ayakaleaf Pro локально на вашем Mac с помощью Docker Desktop и [Ayakaleaf Toolkit](https://github.com/ayaka-notes/toolkit). В руководстве используется адрес `http://localhost:8080`, данные хранятся в вашем домашнем каталоге, а компиляция выполняется с TeX Live 2026 в изолированных контейнерах.

Docker Desktop запускает приложение, MongoDB, Redis и компилятор TeX Live в виртуальной машине Linux. Устанавливать MongoDB, Redis или MacTeX в самой macOS не нужно.

Используйте эту конфигурацию для личного использования и локального тестирования. Для постоянно работающего общего сервиса мы рекомендуем [руководство для Linux](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/linux) с HTTPS, резервным копированием и управлением доступом. Экземпляр недоступен, пока Mac находится в спящем режиме или Docker Desktop остановлен, см. раздел [Обеспечение доступности экземпляра](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

## Прежде чем начать

Вам понадобится:

* Версия macOS, поддерживаемая [Docker Desktop for Mac](https://docs.docker.com/desktop/setup/install/mac-install/).
* Git, [Homebrew](https://brew.sh/) и GNU sed. Toolkit использует параметры GNU sed, которые не принимает встроенный в macOS BSD sed.
* Достаточно ресурсов и для macOS, и для Docker. Для небольшого локального экземпляра начните с 4 CPU и 8 ГБ памяти, выделенных Docker Desktop. Это рекомендуемая отправная точка, а не измеренный минимум.
* Не менее 40 ГБ свободного места для полного образа TeX Live, а также место для ваших проектов. Проверьте и свободное место на Mac, и лимит использования диска в Docker Desktop. Начните с одной версии TeX Live: каждая дополнительная версия требует примерно столько же места.

Образы приложения и TeX Live публикуются для `arm64` и `amd64`. На Apple silicon позвольте Docker выбрать нативный образ ARM и не задавайте принудительно `platform: linux/amd64`.

## Шаги

> [card] [0. Установка Docker Desktop](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/0.-setup-docker-desktop.md)

> [card] [1. Загрузка Toolkit](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/1.-download-the-toolkit.md)

> [card] [2. Знакомство с Toolkit](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md)

> [card] [3. Инициализация конфигурации](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/3.-initialize-the-configuration.md)

> [card] [4. Получение образов Ayakaleaf Pro](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/4.-get-ayakaleaf-pro-images.md)

> [card] [5. Персонализация экземпляра](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/5.-personalizing-your-instance.md)

> [card] [6. Действия после установки](https://ayakaleaf-pro.mintlify.site/ru/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.