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

# Projektien vienti

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

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

### Rajoitukset

Vientiskriptillä on seuraavat rajoitukset:

* Mitään projektiasetuksia, kuten TeX Live -kuvan nimeä tai kääntäjää, ei viedä. Nämä on asetettava, kun projekti ladataan käyttäjän tilille.
* Viedyissä projekteissa ei ole mitään versiohistoriaa.
* Mitään 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 ennen).
* Mitään kommentteja eikä seurattujen muutosten tietoja viedä.
* Projektin keskusteluhistoriaa ei viedä.

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

### **Liput**

| Nimi           | Kuvaus                                                                              |
| -------------- | ----------------------------------------------------------------------------------- |
| `--help`       | Näytä ohje                                                                          |
| `--user-id`    | Käyttäjän tunnus (pakollinen, ellei käytössä ole `--export-all` tai `--project-id`) |
| `--project-id` | Vie yksi projekti (**ei** voida käyttää yhdessä `--user-id` tai `--export-all`)     |
| `--list`       | Listaa käyttäjän projektit (**ei** voida käyttää yhdessä `--output`)                |
| `--output`     | Tulostettava zip-tiedosto (yksittäistä vientiä varten)                              |
| `--export-all` | Vie kaikkien käyttäjien projektit (vaatii `--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 viemiseen:

{% 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 Edition <= 3.5.13, sinun on päivitettävä yllä oleva esimerkki käyttämään **`export-legacy-user-projects.js`** skriptiä.
{% endhint %}

### **Valmiiksi saattaminen**

Kun vienti on valmis, voit käyttää tiedostoja isäntäkoneen hakemistosta, joka on bind-mountattu kohtaan **/var/lib/overleaf** tiedostossasi **docker-compose.yml** tai `OVERLEAF_DATA_PATH` ympäristömuuttujassa **config/overleaf.rc** tiedostossa, jos käytät Toolkitia.

{% hint style="info" %}
Overleaf sallii tällä hetkellä samannimiset projektit. Jos käyttäjän projektissa on päällekkäinen nimi, nämä projektit lisätään silti käyttäjän Zip-vientiin, mutta purettaessa vain yksi versio on läsnä. Linuxissa, `unzip -B` kirjoittaa samannimiset tiedostot varmuuskopiotiedostoina ylikirjoittamisen sijaan.
{% 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://ayakaleaf-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.
