> 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/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 rekommenderas inte och kan leda till olika typer av prestandafel.

Ett vanligt fel som kompileringsprocessen ser ä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är 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 installationer föreslår vi att man bara åsidosätter bind-mounten från NFS, vilket undviker att ändra sökvägar i programmet. Här är ett exempel på ett `docker-compose` konfigurationsutdrag med användning av en scratch-disk som är monterad vid `/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 igen med en fullständig kompileringskörning.

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 gör att tjänsten `mongo` inte startar</summary>

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

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

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

{% endcode %}

För att undvika detta fel behöver 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-containrarna, lägg till följande i `config/docker-compose.override.yml` (skapa den här filen om den inte redan finns):

{% 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 resulterar i en omstartsslinga</summary>

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

Om du ser raden `Fatal: 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 # Servern initierad
1:M 11 Feb 2024 15:19:22.609 # Fatal: Kan inte initiera bakgrundsjobb.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis startar oO0OoO0OoO0Oo
```

{% endcode %}

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

För mer information, se Redis upstream-problem: <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 på förhandsvisnings-/miniatyrbilden i mallgalleriet</summary>

I vissa fall kan förhandsvisnings-/miniatyrbilderna som genereras av Server Pro skapas i fel orientering och kräva manuell åtgärd för att rättas till. 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-ID:t. Gå 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 korrigeringskommandot. Kö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>

Den `\write18` kommandot är inaktiverat som standard i Community Edition eftersom alla kompileringar sker i samma `sharelatex` container; detta är det säkrare standardläget.

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 att kompilera igen.

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://overleaf-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.