> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/pt/suporte/troubleshooting.md).

# Resolução de problemas

{% hint style="info" %}
Se estiver a usar uma versão anterior, utilize `sharelatex` em vez de `overleaf` nos nomes de 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 vários tipos de erros de desempenho.

Um erro comum que as compilações encontram é:

```
EBUSY: resource busy or locked, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

Em particular, desaconselhamos a utilização 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` baseadas em, sugerimos simplesmente substituir a montagem por bind 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 do 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 o novo local após a atualização. O compilador LaTeX pode recriar todos os ficheiros com uma nova execução completa da compilação.

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 arranque</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" %}

```
Failed to start up WiredTiger under any compatibility version.
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 por bind (consulte 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 nos 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ícios</summary>

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

Se vir a linha `Fatal: Can't initialize Background Jobs`, 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 # Server initialized
1:M 11 Feb 2024 15:19:22.609 # Fatal: Can't initialize Background Jobs.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis is starting 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, veja o problema upstream 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 das imagens de pré-visualização/miniatura da galeria de templates</summary>

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

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

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

Encontre o ID do template. Navegue até à galeria de templates da sua instância (/templates/all), abra um template afetado e copie o ID do URL (por exemplo: <https://your-instance-url/templates/6645d346c224815e9460a695>). Execute o comando de correção. Execute o seguinte comando a partir do host Docker (substitua o ID do template 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 tem as chamadas do sistema ativadas. Para pdflatex, isto é 'pdflatex -shell-escape'.</summary>

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

Se quiser ativá-lo 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://overleaf-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.