> 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/fi/yllapito/data-and-backups/exporting-projects.md).

# Projektien vienti

Server Prossa ja Community Editionissa `5.4.0` olemme lisänneet skriptin, jonka avulla ylläpitäjät voivat viedä kaikki käyttäjien projektit (mukaan lukien ne, jotka ovat yhä näkyvissä kohdassa **Poistetut** ja **Roskakoriin siirretyt** kansiot) levyllä olevaan hakemistoon.

{% hint style="info" %}
Tämän skriptin suorittamisen tulos on sama kuin kaikkien projektien Zip-tiedoston manuaalinen lataaminen käyttäjän projektin hallintapaneelista. Skripti tyhjentää kaikki odottavat muutokset ennen latauksen aloittamista varmistaakseen, että vienti sisältää projektin uusimman version.
{% endhint %}

### Rajoitukset

Vientiskriptillä on seuraavat rajoitukset:

* Projektin asetuksia, kuten TeX Live -kuvan nimeä tai kääntäjää, ei viedä. Ne on asetettava, kun projekti ladataan käyttäjän tilille.
* Viedyissä projekteissa ei ole mitään versiohistoriaa.
* Yhteistyötietoja ei säilytetä. Projektit on jaettava uudelleen. Jos käytössä on linkkijako, Näytä- ja Muokkaa-linkit luodaan uudelleen (ne eivät ole samat kuin aiemmin).
* Kommentteja ja muutosten seurannan tietoja ei viedä.
* Projektin keskusteluhistoriaa ei viedä.

{% hint style="danger" %}
Tämä skripti on **ei** suunniteltu korvaamaan täysi järjestelmän varmuuskopio. Jotta voit palauttaa instanssisi katastrofipalautusskenaariossa, me **vahvasti** suosittelemme ottamaan [yhtenäisen varmuuskopion](https://docs.overleaf.com/on-premises/maintenance/data-and-backups/..#performing-a-consistent-backup).
{% endhint %}

### **Valitsimet**

| Nimi           | Kuvaus                                                                         |
| -------------- | ------------------------------------------------------------------------------ |
| `--help`       | Näytä ohje                                                                     |
| `--user-id`    | Käyttäjän tunnus (pakollinen, ellei käytetä `--export-all` tai `--project-id`) |
| `--project-id` | Vie yksi projekti (**ei** voi käyttää yhdessä `--user-id` tai `--export-all`)  |
| `--list`       | Listaa käyttäjän projektit (**ei** voi käyttää yhdessä `--output`)             |
| `--output`     | Tulostettava zip-tiedosto (yksittäisiä vientitoimintoja varten)                |
| `--export-all` | Vie kaikkien käyttäjien projektit (edellyttää `--output-dir`)                  |
| `--output-dir` | Hakemisto kaikkien käyttäjien vientitiedostojen tallentamiseen                 |
| `--log-level`  | Tuetut lokitasot: `trace`\|`debug`\|`info`\|`warn`\|`error`\|`fatal`           |

### **Käyttö**

Käytä seuraavaa komentoa kaikkien käyttäjien projektien vientiin:

{% code overflow="wrap" %}

```bash
# Overleaf Toolkitin käyttäjät
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"

# Vanhan docker-compose.yml:n käyttäjät
docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"
```

{% endcode %}

{% hint style="info" %}
Jos käytössäsi on Server Pro tai Community Editition <= 3.5.13, sinun on päivitettävä yllä oleva esimerkki käyttämään **`export-legacy-user-projects.js`** -skriptiä.
{% endhint %}

### **Valmistuminen**

Kun vienti on valmis, voit käyttää tiedostoja isännän hakemiston kautta, joka on bind-mountattu kohteeseen **/var/lib/overleaf** sinun **docker-compose.yml** tiedostossa tai `OVERLEAF_DATA_PATH` ympäristömuuttujassa **config/overleaf.rc** tiedostossa, jos käytät Toolkitia.

{% hint style="info" %}
Overleaf sallii tällä hetkellä projektien samannimisyydet. Jos käyttäjän projektissa on kaksoiskappale, nämä projektit lisätään silti käyttäjän Zip-vientiin, mutta purettaessa mukana on vain yksi versio. Linuxissa, `unzip -B` kirjoittaa tiedostot, joilla on sama nimi, varmuuskopiotiedostoina sen sijaan, että se korvaisi ne.
{% endhint %}


---

# 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/fi/yllapito/data-and-backups/exporting-projects.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.
