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

# Projekte exportieren

In Server Pro und Community Edition `5.4.0` haben wir ein Skript aufgenommen, mit dem Administratoren alle Benutzerprojekte exportieren können (einschließlich derer, die noch sichtbar in den **Gelöscht** und **Papierkorb** Ordner) in ein Verzeichnis auf der Festplatte.

{% hint style="info" %}
Die Ausgabe beim Ausführen dieses Skripts ist dieselbe wie beim manuellen Herunterladen eines ZIP-Archivs aller Projekte aus dem Projekt-Dashboard des Benutzers. Das Skript leert alle ausstehenden Änderungen, bevor der Download beginnt, um sicherzustellen, dass der Export die neueste Version des Projekts enthält.
{% endhint %}

### Einschränkungen

Das Exportskript hat die folgenden Einschränkungen:

* Es werden keine Projekteinstellungen exportiert, wie etwa der TeX-Live-Image-Name oder der Compiler. Diese müssen festgelegt werden, wenn das Projekt in das Benutzerkonto hochgeladen wird.
* Exportierte Projekte enthalten keinen Versionsverlauf.
* Es werden keine Informationen zu Mitbearbeitern beibehalten. Projekte müssen erneut freigegeben werden. Wenn Link-Sharing verwendet wird, werden Ansicht- und Bearbeitungslinks neu generiert (sie sind nicht mehr dieselben wie zuvor).
* Kommentare und Informationen zu nachverfolgten Änderungen werden nicht exportiert.
* Der Chatverlauf des Projekts wird nicht exportiert.

{% hint style="danger" %}
Dieses Skript ist **nicht** dazu gedacht, ein vollständiges System-Backup zu ersetzen. Um sicherzustellen, dass Sie Ihre Instanz in einem Disaster-Recovery-Szenario wiederherstellen können, empfehlen wir **dringend** die Erstellung eines [konsistenten Backups](https://docs.overleaf.com/on-premises/maintenance/#performing-a-consistent-backup).
{% endhint %}

### **Optionen**

| Name           | Beschreibung                                                                                            |
| -------------- | ------------------------------------------------------------------------------------------------------- |
| `--help`       | Hilfe anzeigen                                                                                          |
| `--user-id`    | Die Benutzer-ID (erforderlich, sofern nicht mit `--export-all` oder `--project-id`)                     |
| `--project-id` | Ein einzelnes Projekt exportieren (**kann nicht** verwendet werden mit `--user-id` oder `--export-all`) |
| `--list`       | Projekte des Benutzers auflisten (**kann nicht** verwendet werden mit `--output`)                       |
| `--output`     | Ausgabedatei im ZIP-Format (für einzelne Exportvorgänge)                                                |
| `--export-all` | Alle Projekte aller Benutzer exportieren (erfordert `--output-dir`)                                     |
| `--output-dir` | Verzeichnis zum Speichern der Exportdateien aller Benutzer                                              |
| `--log-level`  | Unterstützte Log-Level: `trace`\|`debug`\|`info`\|`warn`\|`error`\|`fatal`                              |

### **Verwendung**

Verwenden Sie den folgenden Befehl, um Projekte für alle Benutzer zu exportieren:

{% code overflow="wrap" %}

```bash
# Benutzer des Overleaf Toolkit
$ 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"

# Benutzer der alten docker-compose.yml
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" %}
Wenn Sie Server Pro oder Community Edition <= 3.5.13 ausführen, müssen Sie das obige Beispiel so anpassen, dass es das **`export-legacy-user-projects.js`** Skript verwendet.
{% endhint %}

### **Abschluss**

Sobald der Export abgeschlossen ist, können Sie über das Verzeichnis auf dem Host auf die Dateien zugreifen, das per Bind-Mount an **/var/lib/overleaf** in Ihrer **docker-compose.yml** Datei oder die `OVERLEAF_DATA_PATH` Umgebungsvariable in der **config/overleaf.rc** Datei, wenn Sie das Toolkit verwenden.

{% hint style="info" %}
Overleaf erlaubt derzeit doppelte Projektnamen. Wenn ein Projekt eines Benutzers ein Duplikat enthält, werden diese Projekte dennoch dem ZIP-Export des Benutzers hinzugefügt, aber beim Entpacken wird nur eine Version vorhanden sein. Unter Linux, `unzip -B` schreibt Dateien mit demselben Namen als Sicherungsdateien, anstatt sie zu überschreiben.
{% 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/de/wartung/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.
