> ## 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-synkronisering

<Info>
  Den här funktionen är utvecklad av [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro). Den introducerades i v6.4.0 och finns i senare versioner. Den är fortfarande i betastatus. Vi behöver din återkoppling om du stöter på problem.
</Info>

Dropbox-synkronisering håller en användares projekt synkroniserade med användarens Dropbox, precis som på Overleaf Cloud: när en användare har länkat sitt Dropbox-konto visas vart och ett av användarens projekt som en mapp i `Apps/<your Dropbox app>/`, ändringar i Overleaf skickas till Dropbox och ändringar som görs i Dropbox kommer tillbaka till Overleaf.

### Konfigurera Dropbox-synkronisering

<Warning>
  Du måste aktivera [git-bridge](/sv/on-premises/configuration/overleaf-toolkit/git-integration) först: utan den döljs avsnittet för projektsynkronisering i kontoinställningarna.

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

Skapa en app i [Dropbox App Console](https://www.dropbox.com/developers/apps), inloggad med det Dropbox-konto som ska äga appen:

1. Klicka på **Create app** och fyll sedan i sidan:
   * **1. Choose an API**: välj **Scoped access**.
   * **2. Choose the type of access you need**: välj **App folder**, inte **Full Dropbox**. Overleaf synkroniserar bara inuti appens mapp.
   * **3. Name your app**: ange ett namn, t.ex. `Overleaf`. Det måste vara unikt på Dropbox. Varje användares projekt visas i `Apps/<name of your app>/` i användarens Dropbox, och det här namnet är `DROPBOX_APP_NAME` nedan.
   * Klicka på **Create app**. Appen öppnas på fliken **Settings**.
2. På fliken **Permissions**, under **Files and folders**, markerar du `files.metadata.write`, `files.content.write` och `files.content.read`. `account_info.read` och `files.metadata.read` markeras tillsammans med dem och kan inte avmarkeras. Markera inga andra behörigheter.
3. Klicka på **Submit** i fältet längst ned på fliken **Permissions**. **Utan Submit sparas inte behörigheterna**, och Dropbox vägrar då att synkronisera filer för de användare som länkar sitt konto.

<Frame caption="Dropbox App Console: behörigheterna som ska markeras, sparade med 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. På fliken **Settings**, under **OAuth 2**, anger du `${OVERLEAF_SITE_URL}/user/dropbox/oauth/callback` i **Redirect URIs** och **klickar sedan på Add**. Det räcker inte att skriva in URI:n: den sparas först när den visas i listan ovanför fältet.

<Frame caption="Dropbox App Console: ange redirect-URI:n och klicka sedan på Add">
  <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. På fliken **Settings**, under **Webhooks**, anger du `${OVERLEAF_SITE_URL}/dropbox/webhook` i **Webhook URIs** och **klickar sedan på Add** även här. Dropbox anropar den direkt för att kontrollera den, så Overleaf måste redan köras med inställningarna nedan och vara nåbar från internet (se [Webhook](#webhook)). Dess status visar **Enabled** när kontrollen har godkänts.

Kopiera **App key** och **App secret** (klicka på **Show**) från fliken **Settings** och lägg sedan till följande inställningar i dina filer med miljövariabler för Overleaf. Du kan lägga till webhooken (steg 5) när Overleaf körs med dem.

```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>
  * Kontrollera att `OVERLEAF_SITE_URL` är korrekt angiven innan du konfigurerar redirect-URI:n och webhooken.
  * Dropbox fastställer behörigheterna för en token när användaren länkar sitt konto: att skicka in behörigheter ändrar inte befintliga token. Användare som länkade innan behörigheterna skickades in, eller innan du ändrade dem, måste avlänka och länka sitt Dropbox-konto igen.
  * En ny app har statusen **Development**. Om **Development users** på fliken **Settings** visar **Only you** kan bara ditt Dropbox-konto länkas: klicka på **Enable additional users** för att låta andra användare länka sina konton. Därefter visas hur många användare som har länkat, t.ex. `1 / 500`: **en app i Development kan ha högst 500 användare**. För fler användare klickar du på **Apply for production**, och Dropbox granskar då appen.
</Warning>

Om du befinner dig i en region med begränsad nätverksåtkomst kan du behöva konfigurera en proxy för att nå Dropbox. Ange följande miljövariabel: `DROPBOX_SYNC_PROXY_URL=http://10.0.0.1:10808`. Det måste vara en vanlig HTTP/HTTPS-framåtproxy och får inte använda `127.0.0.1`.

### Webhook

Dropbox meddelar Overleaf om ändringar i Dropbox via en webhook, så att de syns i Overleaf inom några sekunder. Webhooken går till din webbplats adress, `${OVERLEAF_SITE_URL}/dropbox/webhook`, och ingen extra port behövs, men **Dropbox måste kunna nå den från internet**. När du lägger till den i App Console kontrollerar Dropbox den direkt.

Utan webhook, till exempel på en server som Dropbox inte kan nå, skickas ändringar i Overleaf fortfarande till Dropbox, men ändringar i Dropbox kommer bara tillbaka när en användare klickar på *sync this project now* i Dropbox-dialogrutan i redigeraren.

### Så fungerar synkroniseringen

* **Länkning**: när en användare länkar sitt Dropbox-konto skickas de projekt som användaren äger till Dropbox. Projekt som delats med användaren visas i Dropbox vid sin nästa ändring.
* **Från Overleaf till Dropbox**: nya filer, namnbyten, flyttningar, borttagningar och namnbyten på projekt skickas direkt. Ändringar i redigeraren skickas när Overleaf sparar dem i sin lagring, några minuter efter att alla har lämnat projektet. För att skicka dem tidigare klickar du på *sync this project now* i Dropbox-dialogrutan i redigeraren (en gång per minut).
* **Från Dropbox till Overleaf**: nya och ändrade filer, nya mappar och borttagningar i en projektmapp tillämpas på projektet. En ny mapp högst upp i appmappen blir ett nytt projekt. Om du tar bort en projektmapp i Dropbox markeras projektet som borttaget i Overleaf.
* **Konflikter**: när en fil ändras på båda ställena samtidigt vinner den senaste ändringen. Dropbox kan spara den andra versionen som en *conflicted copy*.
* **Medarbetare**: medarbetare som länkar sin Dropbox får de projekt som delats med dem. Användare med endast läsbehörighet och granskare får projektet, men deras ändringar i Dropbox synkroniseras inte tillbaka till Overleaf.
* **Ignorerade filer**: filer som Overleaf inte synkroniserar, som byggutdata (`.aux`, `.log`, …), `.DS_Store` eller virtuella Python-miljöer, finns bara kvar i Dropbox.

### Q\&A

<Accordion title="Varför kan en användare inte länka sitt Dropbox-konto?">
  <strong>Svar:</strong>

  * Projekt matchas mot Dropbox-mappar efter namn, så en användare som har två projekt med samma namn ombeds först byta namn på ett av dem.
  * Ett Dropbox-konto kan bara länkas till ett Overleaf-konto.
</Accordion>

<Accordion title="Varför avlänkades ett Dropbox-konto?">
  <strong>Svar:</strong> Overleaf avlänkar ett Dropbox-konto när Dropbox avvisar dess token (till exempel efter att användaren har tagit bort appen i Dropbox), när Dropbox-lagringen är full eller när Dropbox har stängt av kontot. Användaren kan länka det igen när problemet är löst.
</Accordion>

<Accordion title="Kan jag byta namn på en projektmapp i Dropbox?">
  <strong>Svar:</strong> Byt i stället namn på projektet i Overleaf. För Overleaf innebär ett namnbyte av mappen i Dropbox att projektmappen tas bort och en ny skapas, så det gamla projektet markeras som borttaget och ett nytt projekt skapas från filerna.
</Accordion>


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