> 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/on-premises-cs/podpora/troubleshooting.md).

# Řešení problémů

{% hint style="info" %}
Pokud používáte starší verzi, použijte prosím `sharelatex` namísto `Overleaf` v názvech cest.
{% endhint %}

<details>

<summary>Spouštění Overleafu s NFS souborovým systémem</summary>

Připojení souborového systému NFS v kontejneru Overleafu je technicky možné, ale nedoporučuje se a může vést k různým typům chyb výkonu.

Jedna běžná chyba, kterou kompilace hlásí, je:

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

Zvláště nedoporučujeme používat souborové systémy založené na NFS pro dočasná data, například adresáře používané pro data kompilace. Doporučujeme používat místní dočasný disk, nejlépe místní SSD, pro následující adresáře.

Pro `docker-compose` založených na nastavení doporučujeme jednoduše přepsat bind-mount z NFS, což zabrání změnám cest v aplikaci. Zde je příklad `docker-compose` konfiguračního výňatku s použitím dočasného disku, který je připojen na `/scratch`:

{% code title="výňatek 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 %}

Není nutné po aktualizaci migrovat žádné existující soubory z NFS do jejich nového umístění. Sestavovač LaTeXu může při dalším úplném běhu kompilace znovu vytvořit všechny soubory.

Další podrobnosti viz: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>Spuštění Overleafu ve Windows nebo macOS způsobí, že se služba `mongo` nespustí</summary>

Pokud provozujete Overleaf ve Windows nebo macOS, `mongo` služba se nemusí podařit znovu spustit s chybou:

{% code title="Ukázka chyby" %}

```
Nepodařilo se spustit WiredTiger v žádné verzi kompatibility.
Důvod: 1: Operace není povolena
```

{% endcode %}

Aby se této chybě zabránilo, je třeba data ukládat do svazku, nikoli do bind-mountovaného adresáře (viz `mongo` dokumentace image pro další podrobnosti: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Chcete-li ukládat data uvnitř svazků Docker připojených v kontejnerech MongoDB a Redis, přidejte následující do `config/docker-compose.override.yml` (vytvořte tento soubor, pokud ještě neexistuje):

{% 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 %}

Další informace viz: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>Upgrade na Redis 6.2 vede k restartovací smyčce</summary>

Použijte `docker logs redis` příkaz k výpisu kopie logů.

Pokud uvidíte řádek `Fatální chyba: Nelze inicializovat úlohy na pozadí`, celý výstup bude vypadat zhruba takto:

{% code title="Příklad logu Redis" %}

```
1:M 11 Feb 2024 15:19:22.609 # Server inicializován
1:M 11 Feb 2024 15:19:22.609 # Fatální chyba: Nelze inicializovat úlohy na pozadí.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis se spouští oO0OoO0OoO0Oo
```

{% endcode %}

To může souviset s verzí Dockeru, která je právě používána. Aktualizace na verzi >= 20.10.10 by tento problém měla vyřešit.

Další informace najdete v upstream problému Redis: <https://github.com/redis/redis/issues/12362>

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

</details>

<details>

<summary>Chybně orientované náhledové obrázky/miniatury v galerii šablon</summary>

V některých případech mohou být náhledové obrázky/miniatury generované Server Pro vytvořeny v nesprávné orientaci a pro opravu vyžadují ruční zásah. Tyto obrázky jsou uloženy v `/var/lib/overleaf/data/template_files/` (>= 5.0.3) a `/var/lib/sharelatex/data/template_files/` (starších).

Doporučujeme před provedením jakýchkoli změn tuto složku zazálohovat.

Pro každou dotčenou šablonu budete muset postupovat podle následujících kroků:

Najděte ID šablony. Přejděte do galerie šablon vaší instance (/templates/all), otevřete dotčenou šablonu a zkopírujte ID z adresy URL (například: <https://your-instance-url/templates/6645d346c224815e9460a695>). Spusťte opravný příkaz. Spusťte následující příkaz na hostiteli Dockeru (nahraďte ID šablony tím, které jste zkopírovali, a podle potřeby upravte cestu):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

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

</details>

<details>

<summary>Ověřte, že máte povolena systémová volání. U pdflatex je to 'pdflatex -shell-escape'.</summary>

Pole `\write18` příkaz je ve Community Edition ve výchozím nastavení zakázán, protože všechny kompilace probíhají uvnitř stejného `sharelatex` kontejneru; toto je bezpečnější výchozí nastavení.

Pokud jej chcete pro pdflatex povolit, vytvořte `latexmkrc` soubor v kořenovém adresáři projektu s následujícím obsahem:

{% code title="latexmkrc" %}

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

{% endcode %}

Poté zkuste znovu kompilovat.

Odkaz: <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/on-premises-cs/podpora/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.