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.

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

2. 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.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	O endereço de e-mail pelo qual os usuários podem entrar em contato com o responsável pelo site.	[e-mail]

   Depois de atualizar essas variáveis de ambiente, salve e saia.

3. Configure o Sandbox Compile

   Em seguida, configure o TeX Live Full para sandboxed-compiles.md. Abra config/variables.env e atualize as seguintes variáveis de ambiente:

   config/variables.env

   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
   
4. Inicie sua instância

   Para iniciar sua instância, execute:

   Start the instance

   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:

   Start without attaching to logs

   bin/start
   

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

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/ ou http://localhost/ no seu navegador.

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