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

> Execute uma instância local do Ayakaleaf Pro no macOS com o Docker Desktop e o Toolkit.

Nesta seção, executamos o Ayakaleaf Pro localmente no seu Mac com o Docker Desktop e o [Ayakaleaf Toolkit](https://github.com/ayaka-notes/toolkit). O guia usa `http://localhost:8080`, mantém os dados no seu diretório pessoal e compila com o TeX Live 2026 em contêineres sandbox.

O Docker Desktop executa a aplicação, o MongoDB, o Redis e o compilador do TeX Live em uma máquina virtual Linux. Você não instala o MongoDB, o Redis nem o MacTeX no próprio macOS.

Use esta configuração para uso pessoal e testes locais. Para um serviço compartilhado sempre ativo, recomendamos o [guia para Linux](https://ayakaleaf-pro.mintlify.site/pt/on-premises/installation/using-docker-compose/linux), com HTTPS, backups e controle de acesso. A instância fica indisponível enquanto o Mac está em repouso ou o Docker Desktop está parado; consulte [Manter a instância disponível](https://ayakaleaf-pro.mintlify.site/pt/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

## Antes de começar

Você precisa de:

* Uma versão do macOS compatível com o [Docker Desktop for Mac](https://docs.docker.com/desktop/setup/install/mac-install/).
* Git, [Homebrew](https://brew.sh/) e GNU sed. O Toolkit usa opções do GNU sed que o BSD sed embutido no macOS não aceita.
* Recursos suficientes para o macOS e o Docker. Para uma pequena instância local, comece com 4 CPUs e 8 GB de memória alocados ao Docker Desktop. Este é um ponto de partida sugerido, não um mínimo medido.
* Pelo menos 40 GB de armazenamento livre para uma imagem completa do TeX Live, além de espaço para os seus projetos. Verifique tanto o espaço livre no Mac quanto o limite de uso de disco do Docker Desktop. Comece com uma única versão do TeX Live: cada versão adicional precisa de aproximadamente o mesmo espaço.

As imagens da aplicação e do TeX Live são publicadas para `arm64` e `amd64`. No Apple silicon, deixe o Docker escolher a imagem ARM nativa e não force `platform: linux/amd64`.

## Etapas

> [card] [0. Configurar o Docker Desktop](https://ayakaleaf-pro.mintlify.site/pt/on-premises/installation/using-docker-compose/macos/0.-setup-docker-desktop.md)

> [card] [1. Baixar o Toolkit](https://ayakaleaf-pro.mintlify.site/pt/on-premises/installation/using-docker-compose/macos/1.-download-the-toolkit.md)

> [card] [2. Familiarize-se com o Toolkit](https://ayakaleaf-pro.mintlify.site/pt/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md)

> [card] [3. Inicializar a configuração](https://ayakaleaf-pro.mintlify.site/pt/on-premises/installation/using-docker-compose/macos/3.-initialize-the-configuration.md)

> [card] [4. Obter as imagens do Ayakaleaf Pro](https://ayakaleaf-pro.mintlify.site/pt/on-premises/installation/using-docker-compose/macos/4.-get-ayakaleaf-pro-images.md)

> [card] [5. Personalizando sua instância](https://ayakaleaf-pro.mintlify.site/pt/on-premises/installation/using-docker-compose/macos/5.-personalizing-your-instance.md)

> [card] [6. Tarefas pós-instalação](https://ayakaleaf-pro.mintlify.site/pt/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.