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

# 5. Personalizando sua instância

### Personalizando sua instância

Antes de iniciar sua instância do Overleaf pela primeira vez, atualize o arquivo de configuração `config/variables.env` com suas informações personalizadas.

<Steps>
  <Step title="Edite o arquivo de variáveis">
    Abra `config/variables.env` no seu editor de texto favorito e atualize as variáveis de ambiente abaixo com os valores necessários.
  </Step>

  <Step title="Variáveis de ambiente obrigatórias">
    Atualize as seguintes variáveis em `config/variables.env`:

    | Nome | Descrição | Exemplo |
    | - | - | - |
    | `OVERLEAF_SITE_URL` | Onde sua instância do Overleaf está disponível publicamente. Isso é usado em links públicos e ao conectar via websockets, portanto **deve ser configurado corretamente**! | `https://overleaf.lilliput.com` |
    | `OVERLEAF_EMAIL_FROM_ADDRESS` | Este endereço de e-mail será usado como endereço `from` em todos os e-mails enviados. | `no-reply@lilliput.com` |
    | `OVERLEAF_ADMIN_EMAIL` | O endereço de e-mail pelo qual os usuários podem entrar em contato com o responsável pelo site. | `it-services@lilliput.com` |

    Depois de atualizar essas variáveis de ambiente, salve e saia.
  </Step>

  <Step title="Configure o Sandbox Compile">
    Em seguida, configure o TeX Live Full para [sandboxed-compiles.md](/pt/on-premises/configuration/overleaf-toolkit/sandboxed-compiles "mention"). Abra `config/variables.env` e atualize as seguintes variáveis de ambiente:

    ```dotenv title="config/variables.env" wrap theme={null}
    ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
    ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
    TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
    ```
  </Step>

  <Step title="Inicie sua instância">
    Para iniciar sua instância, execute:

    ```text title="Start the instance" theme={null}
    bin/up
    ```

    Este comando baixará as imagens necessárias, incluindo o texlive, criará os contêineres (usando suas personalizações) e iniciará a instância. Você deverá ver a saída de log dos vários contêineres Docker.

    Para iniciá-los novamente mais tarde (sem se conectar à saída de log), execute:

    ```text title="Start without attaching to logs" theme={null}
    bin/start
    ```
  </Step>
</Steps>

<Info>
  O Toolkit usa o `docker compose` para gerenciar os contêineres Docker do Overleaf. O Toolkit fornece um conjunto de scripts que encapsulam o `docker compose` e cuidam da maioria dos detalhes para você.
</Info>

Se tudo correr bem, você deverá conseguir ver a página de login da sua nova instância do Overleaf acessando [http://127.0.0.1/](http://127.0.0.1/) ou [http://localhost/](http://localhost/) no seu navegador.

<Warning>
  Dependendo da sua configuração de rede e de onde sua instância do Overleaf está hospedada, talvez seja necessário fazer alterações adicionais de configuração. Consulte as configurações do Toolkit para mais detalhes: [toolkit-settings.md](/pt/on-premises/configuration/overleaf-toolkit/toolkit-settings "mention")
</Warning>


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