> 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-no/stotte/troubleshooting.md).

# Feilsøking

{% hint style="info" %}
Hvis du bruker en tidligere versjon, bruk `sharelatex` i stedet for `overleaf` i stinavn.
{% endhint %}

<details>

<summary>Kjører Overleaf med et NFS-filsystem</summary>

Å montere et NFS-filsystem i en Overleaf-container er teknisk mulig, men det anbefales ikke og kan føre til ulike typer ytelsesfeil.

En vanlig feil som kompileringer kan gi, er:

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

Vi fraråder spesielt å bruke NFS-baserte filsystemer for midlertidige data, som katalogene som brukes til kompileringsdata. Vi anbefaler å bruke en lokal scratch-disk, helst en lokal SSD, for følgende kataloger.

For `docker-compose` baserte oppsett foreslår vi ganske enkelt å overstyre bind-mounten fra NFS, noe som unngår å endre stier i applikasjonen. Her er et eksempel på en `docker-compose` konfigurasjonsutdrag med bruk av en scratch-disk som er montert på `/scratch`:

{% code title="utdrag av docker-compose" %}

```yaml
tjenester:
  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 er ikke nødvendig å migrere noen eksisterende filer fra NFS til deres nye plassering etter oppdateringen. LaTeX-kompilatoren kan gjenskape alle filene ved å kjøre en full kompilering på nytt.

For mer informasjon, se: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>Å kjøre Overleaf på Windows eller macOS fører til at `mongo`-tjenesten ikke starter</summary>

Hvis du kjører Overleaf på Windows eller macOS, kan `mongo` tjenesten mislykkes i å starte på nytt, med en feil:

{% code title="Eksempel på feil" %}

```
Kunne ikke starte opp WiredTiger under noen kompatibilitetsversjon.
Årsak: 1: Operasjon ikke tillatt
```

{% endcode %}

For å unngå denne feilen må dataene lagres i et volum i stedet for i en bind-montert katalog (se `mongo` bildedokumentasjonen for flere detaljer: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). For å lagre data i Docker-volumer som er montert inne i MongoDB- og Redis-containerne, legg til følgende i `config/docker-compose.override.yml` (opprett denne filen hvis den ikke finnes ennå):

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

```yaml
volumes:
  mongo-data:
  redis-data:

tjenester:
  mongo:
    volumes:
      - mongo-data:/data/db

  redis:
    volumes:
      - redis-data:/data
```

{% endcode %}

For mer informasjon se: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>Oppgradering til Redis 6.2 fører til en omstartsløkke</summary>

Bruk `docker logs redis` kommandoen for å skrive ut en kopi av loggene.

Hvis du ser linjen `Fatal: Can't initialize Background Jobs`, vil hele utdataene se omtrent slik ut:

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

```
1:M 11 Feb 2024 15:19:22.609 # Serveren ble initialisert
1:M 11 Feb 2024 15:19:22.609 # Fatal: Kan ikke initialisere bakgrunnsjobber.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis starter oO0OoO0OoO0Oo
```

{% endcode %}

Dette kan være relatert til versjonen av Docker som brukes for øyeblikket. Oppdatering til en versjon >= 20.10.10 bør løse dette problemet.

For mer informasjon, se Redis' upstream-issue: <https://github.com/redis/redis/issues/12362>

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

</details>

<details>

<summary>Feil orientering av forhåndsvisnings-/miniatyrbilder i malgalleriet</summary>

Av og til kan forhåndsvisnings-/miniatyrbildene som genereres av Server Pro, bli laget i feil orientering og kreve manuell inngripen for å korrigere dem. Disse bildene er lagret i `/var/lib/overleaf/data/template_files/` (>= 5.0.3) og `/var/lib/sharelatex/data/template_files/` (tidligere).

Vi anbefaler å ta sikkerhetskopi av denne mappen før du gjør noen endringer.

Du må følge trinnene nedenfor for hver berørte mal:

Finn mal-IDenGå til instansens malgalleri (/templates/all), åpne en berørt mal og kopier ID-en fra URL-en (for eksempel: <https://your-instance-url/templates/6645d346c224815e9460a695).Kjør> korrigeringskommandoenKjør følgende kommando fra Docker-verten (erstatt mal-ID-en med den du kopierte, og oppdater stien hvis det er aktuelt):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

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

</details>

<details>

<summary>Vennligst bekreft at du har aktivert systemkall. For pdflatex er dette 'pdflatex -shell-escape'.</summary>

Den `\write18` kommandoen er deaktivert som standard i Community Edition fordi alle kompileringer skjer i samme `sharelatex` containeren; dette er standarden som er tryggest.

Hvis du vil aktivere det for pdflatex, opprett en `latexmkrc` fil i rotmappen til prosjektet ditt med følgende innhold:

{% code title="latexmkrc" %}

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

{% endcode %}

Prøv deretter å kompilere på nytt.

Referanse: <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-no/stotte/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.