> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/pt/suporte/troubleshooting.md).

# Resolução de problemas

{% hint style="info" %}
Se estiver a usar uma versão anterior, por favor use `sharelatex` em vez de `overleaf` nos nomes dos caminhos.
{% endhint %}

<details>

<summary>A executar o Overleaf com um sistema de ficheiros NFS</summary>

Montar um sistema de ficheiros NFS num contentor do Overleaf é tecnicamente possível, mas não é recomendado e pode resultar em diferentes tipos de erros de desempenho.

Um erro comum que ocorre nas compilações é:

```
EBUSY: recurso ocupado ou bloqueado, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

Em particular, desaconselhamos o uso de sistemas de ficheiros suportados por NFS para dados efémeros, como os diretórios usados para dados de compilação. Recomendamos usar um disco local temporário, de preferência um SSD local, para os seguintes diretórios.

Para `docker-compose` para configurações baseadas em docker-compose, sugerimos apenas substituir o bind-mount do NFS, o que evita alterar caminhos na aplicação. Aqui está um exemplo de um `docker-compose` excerto de configuração com a utilização de um disco temporário montado em `/scratch`:

{% code title="excerto de docker-compose" %}

```yaml
services:
  sharelatex:
    environment:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    volumes:
      - nfs:/var/lib/overleaf/data
      - /scratch/cache/:/var/lib/overleaf/data/cache
      - /scratch/compiles/:/var/lib/overleaf/data/compiles
      - /scratch/output/:/var/lib/overleaf/data/output
      - /scratch/tmp/:/var/lib/overleaf/tmp
```

{% endcode %}

Não é necessário migrar quaisquer ficheiros existentes do NFS para a sua nova localização após a atualização. O compilador LaTeX pode recriar todos os ficheiros com uma nova compilação completa.

Para mais detalhes, consulte: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>A execução do Overleaf no Windows ou macOS faz com que o serviço `mongo` não seja iniciado</summary>

Se estiver a executar o Overleaf no Windows ou macOS, o `mongo` serviço pode não reiniciar, com um erro:

{% code title="Exemplo de erro" %}

```
Falha ao iniciar o WiredTiger em qualquer versão de compatibilidade.
Motivo: 1: Operação não permitida
```

{% endcode %}

Para evitar este erro, os dados precisam de ser armazenados num volume em vez de num diretório montado com bind (veja a `mongo` documentação da imagem para mais detalhes: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Para armazenar dados dentro de volumes Docker montados dentro dos contentores MongoDB e Redis, adicione o seguinte a `config/docker-compose.override.yml` (crie este ficheiro se ainda não existir):

{% code title="config/docker-compose.override.yml" %}

```yaml
volumes:
  mongo-data:
  redis-data:

services:
  mongo:
    volumes:
      - mongo-data:/data/db

  redis:
    volumes:
      - redis-data:/data
```

{% endcode %}

Para mais informações, consulte: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>A atualização para Redis 6.2 resulta num ciclo de reinício</summary>

Use o `docker logs redis` comando para produzir uma cópia dos registos.

Se vir a linha `Fatal: Não é possível inicializar tarefas em segundo plano`, a saída completa será algo semelhante a isto:

{% code title="Exemplo de registo do Redis" %}

```
1:M 11 Feb 2024 15:19:22.609 # Servidor inicializado
1:M 11 Feb 2024 15:19:22.609 # Fatal: Não é possível inicializar tarefas em segundo plano.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis está a iniciar oO0OoO0OoO0Oo
```

{% endcode %}

Isto pode estar relacionado com a versão do Docker atualmente em uso. Atualizar para uma versão >= 20.10.10 deverá resolver este problema.

Para mais informações, consulte o problema a montante do Redis: <https://github.com/redis/redis/issues/12362>

Referência: <https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop>

</details>

<details>

<summary>Orientação incorreta de imagens de pré-visualização/miniatura da galeria de modelos</summary>

Ocasionalmente, as imagens de pré-visualização/miniatura geradas pelo Server Pro podem ser criadas com a orientação errada e exigir intervenção manual para serem corrigidas. Estas imagens são armazenadas em `/var/lib/overleaf/data/template_files/` (>= 5.0.3) e `/var/lib/sharelatex/data/template_files/` (anteriores).

Recomendamos fazer uma cópia de segurança desta pasta antes de efetuar quaisquer alterações.

Terá de seguir os passos abaixo para cada modelo afetado:

Encontre o ID do modeloNavegue para a galeria de modelos da sua instância (/templates/all), abra um modelo afetado e copie o ID a partir do URL (por exemplo: <https://your-instance-url/templates/6645d346c224815e9460a695).Execute> o comando de correçãoExecute o seguinte comando a partir do anfitrião Docker (substitua o ID do modelo pelo que copiou e atualize o caminho, se apropriado):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

Referência: <https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images>

</details>

<details>

<summary>Por favor, verifique se ativou chamadas de sistema. Para pdflatex, isto é 'pdflatex -shell-escape'.</summary>

O `\write18` comando está desativado por predefinição na Edição Comunitária devido a todas as compilações acontecerem dentro do mesmo `sharelatex` contentor; esta é a predefinição mais segura.

Se o quiser ativar para pdflatex, crie um `latexmkrc` ficheiro na raiz do seu projeto com o seguinte conteúdo:

{% code title="latexmkrc" %}

```perl
$pdflatex = 'pdflatex --shell-escape';
```

{% endcode %}

Depois tente recompilar.

Referência: <https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/pt/suporte/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.