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

# Řešení problémů

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

<details>

<summary>Spouštění Overleafu na souborovém systému NFS</summary>

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

Jedna častá chyba, kterou kompilace zobrazují, je:

```
EBUSY: zdroj je zaneprázdněn nebo uzamčen, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

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

Pro `docker-compose` založená nasazení navrhujeme jednoduše přepsat bind-mount z NFS, čímž se zabrání změnám cest v aplikaci. Zde je příklad `docker-compose` úryvku konfigurace s použitím scratch disku připojeného na `/scratch`:

{% code title="úryvku docker-compose" %}

```yaml
služby:
  sharelatex:
    prostředí:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    svazky:
      - 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 %}

Po aktualizaci není třeba přesouvat žádné existující soubory z NFS na nové místo. Překladač LaTeXu může při plné kompilaci všechny soubory znovu vytvořit.

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 spouštíte Overleaf ve Windows nebo macOS, `mongo` služba se nemusí podařit restartovat s chybou:

{% code title="Příklad chyby" %}

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

{% endcode %}

Aby se předešlo této chybě, musí být data uložena ve svazku, nikoli v bind-mountovaném adresáři (viz `mongo` dokumentaci obrazu pro více informací: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Chcete-li ukládat data uvnitř Docker svazků připojených v kontejnerech MongoDB a Redis, přidejte k `config/docker-compose.override.yml` (vytvořte tento soubor, pokud ještě neexistuje):

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

```yaml
svazky:
  mongo-data:
  redis-data:

služby:
  mongo:
    svazky:
      - mongo-data:/data/db

  redis:
    svazky:
      - redis-data:/data
```

{% endcode %}

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

</details>

<details>

<summary>Aktualizace na Redis 6.2 vede ke smyčce restartů</summary>

Použijte `docker logs redis` příkaz k vypsání kopie logů.

Pokud vidíte řádek `Fatal: Nelze inicializovat úlohy na pozadí`, bude celý výstup vypadat nějak 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 # Fatal: Nelze inicializovat úlohy na pozadí.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis se spouští oO0OoO0OoO0Oo
```

{% endcode %}

Toto může souviset s verzí aktuálně používaného Dockeru. Aktualizace na verzi >= 20.10.10 by měla tento problém vyřešit.

Další informace viz upstream problém 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>Nesprávná orientace náhledových/miniatur obrázků galerie šablon</summary>

Občas mohou být náhledové/miniatury obrázků generované Server Pro vytvořeny v nesprávné orientaci a k jejich opravě je nutný 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ší).

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

Pro každou postiženou šablonu budete muset postupovat podle níže uvedených kroků:

Najděte ID šablony. Přejděte do galerie šablon své instance (/templates/all), otevřete postiženou šablonu a zkopírujte ID z adresy URL (například: <https://your-instance-url/templates/6645d346c224815e9460a695>). Spusťte příkaz pro opravu. Spusťte následující příkaz z hostitele 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 prosím, že jste povolili systémová volání. Pro 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; to je bezpečnější výchozí nastavení.

Pokud jej chcete pro pdflatex povolit, vytvořte `latexmkrc` soubor v kořenovém adresáři vašeho 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://ayakaleaf-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.