> 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/sv/support/troubleshooting.md).

# Felsökning

{% hint style="info" %}
Om du använder en tidigare version, använd `sharelatex` i stället för `overleaf` i sökvägsnamn.
{% endhint %}

<details>

<summary>Köra Overleaf med ett NFS-filsystem</summary>

Att montera ett NFS-filsystem i en Overleaf-container är tekniskt möjligt, men det rekommenderas inte och kan leda till olika typer av prestandafel.

Ett vanligt fel som kompileringar stöter på är:

```
EBUSY: resursen är upptagen eller låst, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

Vi avråder särskilt från att använda NFS-baserade filsystem för temporära data, som katalogerna som används för kompileringsdata. Vi rekommenderar att använda en lokal scratch-disk, helst en lokal SSD, för följande kataloger.

För `docker-compose` baserade uppsättningar föreslår vi att du helt enkelt åsidosätter bind-mounten från NFS, vilket undviker att ändra sökvägar i applikationen. Här är ett exempel på en `docker-compose` konfigurationsutdrag med användning av en scratch-disk som är monterad på `/scratch`:

{% code title="utdrag ur 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 %}

Det finns inget behov av att migrera några befintliga filer från NFS till deras nya plats efter uppdateringen. LaTeX-kompilatorn kan återskapa alla filer genom att köra en fullständig kompilering igen.

För mer information, se: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>Att köra Overleaf på Windows eller macOS leder till att tjänsten `mongo` inte startar</summary>

Om du kör Overleaf på Windows eller macOS, så `mongo` tjänsten kanske inte kan starta om, med ett fel:

{% code title="Exempel på fel" %}

```
Det gick inte att starta WiredTiger under någon kompatibilitetsversion.
Orsak: 1: Åtgärden är inte tillåten
```

{% endcode %}

För att undvika detta fel måste data lagras i en volym i stället för i en bind-monterad katalog (se `mongo` bilddokumentationen för mer information: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). För att lagra data i Docker-volymer som är monterade i MongoDB- och Redis-behållarna, lägg till följande i `config/docker-compose.override.yml` (skapa den här filen om den inte finns ännu):

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

För mer information, se: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>Uppgradering till Redis 6.2 leder till en omstartsslinga</summary>

Använd `docker logs redis` kommandot för att skriva ut en kopia av loggarna.

Om du ser raden `Fatalt: Kan inte initiera bakgrundsjobb`, kommer hela utmatningen att se ungefär ut så här:

{% code title="Exempel på Redis-logg" %}

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

Detta kan vara relaterat till den version av Docker som för närvarande används. Uppdatering till en version >= 20.10.10 bör lösa detta problem.

För mer information, se Redis upstream-problemet: <https://github.com/redis/redis/issues/12362>

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

</details>

<details>

<summary>Felaktig orientering av förhandsvisnings-/miniatyrbilder i mallgalleriet</summary>

Ibland kan förhandsvisnings-/miniatyrbilderna som genereras av Server Pro skapas i fel orientering och kräva manuell åtgärd för att korrigeras. Dessa bilder lagras i `/var/lib/overleaf/data/template_files/` (>= 5.0.3) och `/var/lib/sharelatex/data/template_files/` (tidigare).

Vi rekommenderar att du säkerhetskopierar den här mappen innan du gör några ändringar.

Du behöver följa stegen nedan för varje berörd mall:

Hitta mall-IDNavigera till instansens mallgalleri (/templates/all), öppna en berörd mall och kopiera ID:t från URL:en (till exempel: <https://your-instance-url/templates/6645d346c224815e9460a695).Kör> korrigeringskommandotKör följande kommando från Docker-värden (ersätt mall-ID:t med det du kopierade och uppdatera sökvägen om det behövs):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

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

</details>

<details>

<summary>Kontrollera att du har aktiverat systemanrop. För pdflatex är detta 'pdflatex -shell-escape'.</summary>

Fältet `\write18` kommandot är inaktiverat som standard i Community Edition eftersom alla kompileringar sker inom samma `sharelatex` container; detta är det säkrare standardalternativet.

Om du vill aktivera det för pdflatex, skapa en `latexmkrc` fil i rotkatalogen för ditt projekt med följande innehåll:

{% code title="latexmkrc" %}

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

{% endcode %}

Försök sedan kompilera om.

Referens: <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/sv/support/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.