> 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/fi/tuki/getting-help.md).

# Avun saaminen

### Diagnostiikkatyökalu

Overleaf Toolkitissa on kätevä `doctor` komentosarja, joka auttaa virheenkorjauksessa. Suorita `bin/doctor` ja komentosarja tulostaa tietoja isäntäympäristöstäsi, asetuksistasi ja Toolkitin tarvitsemista riippuvuuksista. Tämä tuloste voi auttaa myös Overleafin tukitiimiä diagnosoimaan Server Pro -asennusten ongelmia.

{% hint style="info" %}
Overleaf Pro -käyttäjät voivat [avata GitHubissa issue](https://github.com/ayaka-notes/overleaf/issues).

on hyvä idea liittää mukaan `bin/doctor` komentosarjan tuloste viestiisi.
{% endhint %}

### Diagnostiikkatyökalun käyttäminen <a href="#consulting-with-the-doctor" id="consulting-with-the-doctor"></a>

Suorita doctor-komentosarja:

{% code title="Suorita doctor" %}

```bash
bin/doctor
```

{% endcode %}

Näet tulosteen, joka muistuttaa alla olevaa esimerkkiä.

<details>

<summary>Esimerkin koko tuloste</summary>

```
====== Overleaf Doctor ======
- Isäntätiedot
    - Linux
    - Komennon 'lsb_release -a' tuloste:
            LSB-moduuleja ei ole saatavilla.
            Jakelutunnus:	Ubuntu
            Kuvaus:	Ubuntu 22.04.5 LTS
            Versio:	22.04
            Koodinimi:	jammy
- Riippuvuudet
    - bash
        - tila: olemassa
        - versiotiedot: 5.1.16(1)-release
    - docker
        - tila: olemassa
        - versiotiedot: Docker version 28.0.4, build b8034c0
    - docker compose
        - tila: olemassa
        - versiotiedot: Docker Compose version v2.34.0
    - realpath
        - tila: olemassa
        - versiotiedot: realpath (GNU coreutils) 8.32
    - perl
        - tila: olemassa
        - versiotiedot: 5.034000
    - awk
        - tila: olemassa
        - versiotiedot: mawk 1.3.4 20200120
- Docker-taustaprosessi
    - tila: käynnissä
====== Määritykset ======
- config/version
    - tila: olemassa
    - versio: 5.4.0
- config/overleaf.rc
    - tila: olemassa
    - arvot
        - OVERLEAF_DATA_PATH: data/overleaf
        - OVERLEAF_LOG_PATH: data/overleaf/logs
        - SERVER_PRO: true
        - SIBLING_CONTAINERS_ENABLED: true
            - kirjautunut quay.io:hin: true
        - MONGO_ENABLED: true
        - REDIS_ENABLED: true
- config/variables.env
    - tila: olemassa
    - arvot
        - OVERLEAF_FILESTORE_BACKEND: fs
        - OVERLEAF_HISTORY_BACKEND: fs

====== Varoitukset ======
- Ei mitään, kaikki hyvin
====== Loppu ======
```

</details>

### Isäntätiedot

Se `Isäntätiedot` osio sisältää tietoja koneesta, jossa Toolkitia ajetaan (esimerkiksi Linux-jakelu ja versio).

<details>

<summary>Esimerkkituloste isäntätiedoista</summary>

```
- Isäntätiedot
    - Linux
    - Komennon 'lsb_release -a' tuloste:
            LSB-moduuleja ei ole saatavilla.
            Jakelutunnus:	Ubuntu
            Kuvaus:	Ubuntu 22.04.5 LTS
            Versio:	22.04
            Koodinimi:	jammy
```

</details>

### Riippuvuudet

Se `Riippuvuudet` osio luettelee työkalut, joita Toolkit tarvitsee toimiakseen. Jos työkalu on käytettävissä, se näytetään muodossa `tila: käytettävissä` versionumeron kanssa. Jos se puuttuu, se näytetään muodossa `tila: PUUTTUU!` ja varoitus lisätään `doctor` tulosteen loppuun.

<details>

<summary>Esimerkkituloste riippuvuudesta (käytettävissä)</summary>

```
- docker
    - tila: olemassa
    - versiotiedot: Docker version 28.0.4, build b8034c0
```

</details>

<details>

<summary>Esimerkkituloste riippuvuudesta (puuttuu)</summary>

```
- docker
    - tila: PUUTTUU!
```

</details>

Jos jokin riippuvuus puuttuu, Toolkit ei lähes varmasti toimi.

### Asetukset

Se `Asetukset` osio sisältää tietoja tiedostoista `config/` hakemistossa. Kohdassa `config/overleaf.rc`, doctor tulostaa joitakin keskeisiä arvoja. Puuttuvat tiedostot luetellaan muodossa `tila: PUUTTUU!` ja varoitus lisätään `doctor` tulosteen loppuun.

<details>

<summary>Esimerkkituloste asetuksista</summary>

```
====== Määritykset ======
- config/version
    - tila: olemassa
    - versio: 5.4.0
- config/overleaf.rc
    - tila: olemassa
    - arvot
        - OVERLEAF_DATA_PATH: /tmp/overleaf
        - SERVER_PRO: false
        - MONGO_ENABLED: false
        - REDIS_ENABLED: true
- config/variables.env
    - tila: PUUTTUU!
```

</details>

Huomioita yllä olevasta esimerkistä:

* `OVERLEAF_DATA_PATH` asetettuna `/tmp/overleaf` ei välttämättä ole turvallinen sijainti tärkeille tiedoille.
* `MONGO_ENABLED: false` tarkoittaa, että Toolkit ei ota käyttöön omaa MongoDB:tä; varmista `MONGO_URL` että se osoittaa ulkoisesti hallittuun MongoDB:hen tarvittaessa.
* `config/variables.env` puuttuu esimerkistä.

### Varoitukset

Se `Varoitukset` osio tiivistää doctor-komentosarjan löytämät ongelmat. Jos ongelmia ei ole, tämä osio kertoo siitä.

<details>

<summary>Esimerkkituloste varoituksista</summary>

```
====== Varoitukset ======
- määritystiedostoa variables.env ei löydy
- rc-tiedostossa OVERLEAF_DATA_PATH ei ole asetettu
====== Loppu =======
```

</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/fi/tuki/getting-help.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.
