> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Dropbox-Synchronisierung

<Info>
  Diese Funktion wurde von [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) entwickelt. Sie ist ab v6.4.0 verfügbar und befindet sich noch im Beta-Status. Wir freuen uns über Ihr Feedback, falls Probleme auftreten.
</Info>

Die Dropbox-Synchronisierung hält die Projekte eines Benutzers mit seiner Dropbox synchron, wie in Overleaf Cloud: Sobald ein Benutzer sein Dropbox-Konto verknüpft, erscheint jedes seiner Projekte als Ordner in `Apps/<your Dropbox app>/`. Änderungen in Overleaf werden an Dropbox gesendet, und in Dropbox vorgenommene Änderungen gelangen zurück zu Overleaf.

### Dropbox-Synchronisierung einrichten

<Warning>
  Sie müssen zuerst [git-bridge](/de/on-premises/configuration/overleaf-toolkit/git-integration) aktivieren: Ohne git-bridge blenden die Kontoeinstellungen den Bereich für die Projektsynchronisierung aus.

  ```dotenv title="config/overleaf.rc" theme={null}
  GIT_BRIDGE_ENABLED=true
  ```
</Warning>

Erstellen Sie eine App in der [Dropbox App Console](https://www.dropbox.com/developers/apps) und melden Sie sich dabei mit dem Dropbox-Konto an, dem die App gehören soll:

1. Klicken Sie auf **Create app** und füllen Sie die Seite aus:
   * **1. Choose an API**: Wählen Sie **Scoped access**.
   * **2. Choose the type of access you need**: Wählen Sie **App folder**, nicht **Full Dropbox**. Overleaf synchronisiert nur innerhalb des Ordners der App.
   * **3. Name your app**: Geben Sie einen Namen ein, z. B. `Overleaf`. Er muss auf Dropbox eindeutig sein. Die Projekte jedes Benutzers erscheinen in seiner Dropbox unter `Apps/<name of your app>/`, und dieser Name ist unten `DROPBOX_APP_NAME`.
   * Klicken Sie auf **Create app**. Die App öffnet sich auf ihrem Tab **Settings**.
2. Aktivieren Sie auf dem Tab **Permissions** unter **Files and folders** die Berechtigungen `files.metadata.write`, `files.content.write` und `files.content.read`. `account_info.read` und `files.metadata.read` werden dabei automatisch aktiviert und können nicht deaktiviert werden. Aktivieren Sie keine weiteren Berechtigungen.
3. Klicken Sie in der Leiste am unteren Rand des Tabs **Permissions** auf **Submit**. **Ohne Submit werden die Berechtigungen nicht gespeichert**, und Dropbox verweigert die Synchronisierung von Dateien für die Benutzer, die ihr Konto verknüpfen.

<Frame caption="Dropbox App Console: die zu aktivierenden Berechtigungen, gespeichert mit Submit">
  <img src="https://mintcdn.com/ayakaleaf-pro/34P8O6kHo91beEvQ/images/on-premises/dropbox-app-permissions.png?fit=max&auto=format&n=34P8O6kHo91beEvQ&q=85&s=8e99711b1fcf03d3d1655f65fea3a6b8" alt="" width="2302" height="1444" data-path="images/on-premises/dropbox-app-permissions.png" />
</Frame>

4. Geben Sie auf dem Tab **Settings** unter **OAuth 2** im Feld **Redirect URIs** `${OVERLEAF_SITE_URL}/user/dropbox/oauth/callback` ein und **klicken Sie dann auf Add**. Das Eintippen der URI reicht nicht aus: Sie wird erst gespeichert, wenn sie in der Liste über dem Feld erscheint.

<Frame caption="Dropbox App Console: Redirect-URI eingeben und dann auf Add klicken">
  <img src="https://mintcdn.com/ayakaleaf-pro/34P8O6kHo91beEvQ/images/on-premises/dropbox-app-redirect-uri.png?fit=max&auto=format&n=34P8O6kHo91beEvQ&q=85&s=d980dc4dec22a90b5bf1f7e147cfc7c0" alt="" width="2788" height="1450" data-path="images/on-premises/dropbox-app-redirect-uri.png" />
</Frame>

5. Geben Sie auf dem Tab **Settings** unter **Webhooks** im Feld **Webhook URIs** `${OVERLEAF_SITE_URL}/dropbox/webhook` ein und **klicken Sie ebenfalls auf Add**. Dropbox ruft die Adresse sofort auf, um sie zu prüfen. Overleaf muss daher bereits mit den unten stehenden Einstellungen laufen und aus dem Internet erreichbar sein (siehe [Webhook](#webhook)). Der Status zeigt **Enabled** an, sobald die Prüfung erfolgreich ist.

Kopieren Sie den **App key** und das **App secret** (klicken Sie auf **Show**) vom Tab **Settings** und fügen Sie anschließend die folgenden Einstellungen zu Ihren Overleaf-Umgebungsvariablendateien hinzu. Den Webhook (Schritt 5) können Sie hinzufügen, nachdem Overleaf mit diesen Einstellungen läuft.

```dotenv title="config/variables.env" wrap theme={null}
# used to encrypt the user's Dropbox refresh token.
# How to generate: `openssl rand -hex 32`
DROPBOX_TOKEN_CIPHER_PASSWORD=0123456789ABCDEFG # changed to yours

# Dropbox Sync Settings
DROPBOX_ENABLED=true
DROPBOX_APP_KEY=
DROPBOX_APP_SECRET=
# the name of your Dropbox app (step 1), which is the folder name in Apps/
DROPBOX_APP_NAME=Overleaf

# OAuth callback is: ${OVERLEAF_SITE_URL}/user/dropbox/oauth/callback
# Webhook is: ${OVERLEAF_SITE_URL}/dropbox/webhook
# (Optional) DROPBOX_SYNC_PROXY_URL=http://10.0.0.1:10808
```

<Warning>
  * Stellen Sie vor dem Konfigurieren der Redirect-URI und des Webhooks sicher, dass `OVERLEAF_SITE_URL` korrekt gesetzt ist.
  * Dropbox legt die Berechtigungen eines Tokens fest, wenn der Benutzer sein Konto verknüpft: Das Übermitteln von Berechtigungen ändert bestehende Token nicht. Benutzer, die ihr Konto verknüpft haben, bevor die Berechtigungen übermittelt oder von Ihnen geändert wurden, müssen die Verknüpfung ihres Dropbox-Kontos aufheben und es erneut verknüpfen.
  * Eine neue App befindet sich im Status **Development**. Wenn **Development users** auf dem Tab **Settings** **Only you** anzeigt, kann nur Ihr eigenes Dropbox-Konto verknüpft werden: Klicken Sie auf **Enable additional users**, damit auch andere Benutzer ihr Konto verknüpfen können. Danach wird angezeigt, wie viele Benutzer verknüpft sind, z. B. `1 / 500`: **Eine App im Status Development erlaubt höchstens 500 Benutzer**. Für mehr Benutzer klicken Sie auf **Apply for production**, und Dropbox prüft die App.
</Warning>

Wenn Sie sich in einer Region mit eingeschränktem Netzwerkzugang befinden, müssen Sie möglicherweise einen Proxy konfigurieren, um auf Dropbox zuzugreifen. Setzen Sie dazu die folgende Umgebungsvariable: `DROPBOX_SYNC_PROXY_URL=http://10.0.0.1:10808`. Es muss sich um einen standardmäßigen HTTP/HTTPS-Forward-Proxy handeln, und `127.0.0.1` darf nicht verwendet werden.

### Webhook

Dropbox informiert Overleaf über einen Webhook über Änderungen in Dropbox, sodass sie innerhalb von Sekunden in Overleaf erscheinen. Der Webhook wird an die Adresse Ihrer Website gesendet, `${OVERLEAF_SITE_URL}/dropbox/webhook`. Es ist kein zusätzlicher Port erforderlich, aber **Dropbox muss die Adresse aus dem Internet erreichen können**. Wenn Sie den Webhook in der App Console hinzufügen, prüft Dropbox ihn sofort.

Ohne Webhook, zum Beispiel auf einem Server, den Dropbox nicht erreichen kann, werden Änderungen in Overleaf weiterhin an Dropbox gesendet. Änderungen in Dropbox gelangen jedoch erst zurück, wenn ein Benutzer im Dropbox-Dialog des Editors auf *sync this project now* klickt.

### So funktioniert die Synchronisierung

* **Verknüpfen**: Wenn ein Benutzer sein Dropbox-Konto verknüpft, werden die Projekte, die ihm gehören, an Dropbox gesendet. Mit ihm geteilte Projekte erscheinen in Dropbox mit ihrer nächsten Änderung.
* **Von Overleaf zu Dropbox**: Neue Dateien, Umbenennungen, Verschiebungen, Löschungen und Projektumbenennungen werden sofort gesendet. Bearbeitungen im Editor werden gesendet, sobald Overleaf sie in seinem Speicher sichert, einige Minuten nachdem alle das Projekt verlassen haben. Um sie früher zu senden, klicken Sie im Dropbox-Dialog des Editors auf *sync this project now* (einmal pro Minute).
* **Von Dropbox zu Overleaf**: Neue und geänderte Dateien, neue Ordner und Löschungen in einem Projektordner werden auf das Projekt angewendet. Ein neuer Ordner auf der obersten Ebene des App-Ordners wird zu einem neuen Projekt. Das Löschen eines Projektordners in Dropbox markiert das Projekt in Overleaf als gelöscht.
* **Konflikte**: Wenn eine Datei gleichzeitig an beiden Orten geändert wird, gilt die letzte Änderung. Dropbox behält die andere Version möglicherweise als *conflicted copy*.
* **Mitarbeitende**: Mitarbeitende, die ihre Dropbox verknüpfen, erhalten die mit ihnen geteilten Projekte. Mitarbeitende mit reinem Leserecht und Reviewer erhalten das Projekt, aber ihre Änderungen in Dropbox werden nicht zurück zu Overleaf synchronisiert.
* **Ignorierte Dateien**: Dateien, die Overleaf nicht synchronisiert, etwa Build-Ausgaben (`.aux`, `.log`, …), `.DS_Store` oder virtuelle Python-Umgebungen, verbleiben nur in Dropbox.

### Q\&A

<Accordion title="Warum kann ein Benutzer sein Dropbox-Konto nicht verknüpfen?">
  <strong>Antwort:</strong>

  * Projekte werden Dropbox-Ordnern anhand ihres Namens zugeordnet. Ein Benutzer mit zwei gleichnamigen Projekten wird daher zuerst gebeten, eines davon umzubenennen.
  * Ein Dropbox-Konto kann nur mit einem Overleaf-Konto verknüpft werden.
</Accordion>

<Accordion title="Warum wurde die Verknüpfung eines Dropbox-Kontos aufgehoben?">
  <strong>Antwort:</strong> Overleaf hebt die Verknüpfung eines Dropbox-Kontos auf, wenn Dropbox sein Token ablehnt (zum Beispiel nachdem der Benutzer die App in Dropbox entfernt hat), wenn die Dropbox voll ist oder wenn Dropbox das Konto gesperrt hat. Der Benutzer kann das Konto erneut verknüpfen, sobald das Problem behoben ist.
</Accordion>

<Accordion title="Kann ich einen Projektordner in Dropbox umbenennen?">
  <strong>Antwort:</strong> Bitte benennen Sie das Projekt stattdessen in Overleaf um. Für Overleaf bedeutet das Umbenennen des Ordners in Dropbox, dass der Projektordner gelöscht und ein neuer erstellt wird. Das alte Projekt wird daher als gelöscht markiert, und aus den Dateien wird ein neues Projekt erstellt.
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.