> ## 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>
  Denne funksjonen er utviklet av [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro). Den er introdusert fra og med v6.4.0. Den er fortsatt i betastatus. Vi trenger tilbakemeldingen din hvis du får problemer.
</Info>

Dropbox-synkronisering holder prosjektene til en bruker synkronisert med Dropbox-en deres, slik som på Overleaf Cloud: når en bruker har koblet til Dropbox-kontoen sin, vises hvert av prosjektene deres som en mappe i `Apps/<your Dropbox app>/`, endringer i Overleaf sendes til Dropbox, og endringer som gjøres i Dropbox, kommer tilbake til Overleaf.

### Sette opp Dropbox-synkronisering

<Warning>
  Du må aktivere [git-bridge](/no/on-premises/configuration/overleaf-toolkit/git-integration) først: uten den skjuler kontoinnstillingene delen for prosjektsynkronisering.

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

Opprett en app i [Dropbox App Console](https://www.dropbox.com/developers/apps), pålogget med Dropbox-kontoen som skal eie appen:

1. Klikk **Create app**, og fyll deretter ut siden:
   * **1. Choose an API**: velg **Scoped access**.
   * **2. Choose the type of access you need**: velg **App folder**, ikke **Full Dropbox**. Overleaf synkroniserer bare innenfor mappen til appen.
   * **3. Name your app**: skriv inn et navn, f.eks. `Overleaf`. Det må være unikt på Dropbox. Prosjektene til hver bruker vises i `Apps/<name of your app>/` i Dropbox-en deres, og dette navnet er `DROPBOX_APP_NAME` nedenfor.
   * Klikk **Create app**. Appen åpnes på fanen **Settings**.
2. På fanen **Permissions**, under **Files and folders**, krysser du av for `files.metadata.write`, `files.content.write` og `files.content.read`. `account_info.read` og `files.metadata.read` krysses av sammen med dem og kan ikke fjernes. Ikke kryss av for andre tillatelser.
3. Klikk **Submit** i linjen nederst på fanen **Permissions**. **Uten Submit lagres ikke tillatelsene**, og Dropbox nekter å synkronisere filer for brukerne som kobler til kontoen sin.

<Frame caption="Dropbox App Console: tillatelsene som skal krysses av, lagret 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å fanen **Settings**, under **OAuth 2**, skriver du inn `${OVERLEAF_SITE_URL}/user/dropbox/oauth/callback` i **Redirect URIs** og **klikker deretter Add**. Det er ikke nok å skrive inn URI-en: den lagres først når den vises i listen over feltet.

<Frame caption="Dropbox App Console: skriv inn redirect-URI-en, og klikk deretter 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å fanen **Settings**, under **Webhooks**, skriver du inn `${OVERLEAF_SITE_URL}/dropbox/webhook` i **Webhook URIs** og **klikker Add** her også. Dropbox kaller den med en gang for å kontrollere den, så Overleaf må allerede kjøre med innstillingene nedenfor og være tilgjengelig fra internett (se [Webhook](#webhook)). Statusen viser **Enabled** når kontrollen er bestått.

Kopier **App key** og **App secret** (klikk **Show**) fra fanen **Settings**, og legg deretter til følgende innstillinger i Overleaf-miljøvariabelfilene dine. Du kan legge til webhooken (trinn 5) etter at Overleaf kjører 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>
  * Før du konfigurerer redirect-URI-en og webhooken, må du sørge for at `OVERLEAF_SITE_URL` er riktig satt.
  * Dropbox fastsetter tillatelsene til et token når brukeren kobler til kontoen sin: å sende inn tillatelser endrer ikke eksisterende tokener. Brukere som koblet til før tillatelsene ble sendt inn, eller før du endret dem, må koble fra og koble til Dropbox-kontoen sin på nytt.
  * En ny app har statusen **Development**. Hvis **Development users** på fanen **Settings** viser **Only you**, kan bare din egen Dropbox-konto kobles til: klikk **Enable additional users** for å la andre brukere koble til sine. Deretter vises hvor mange brukere som har koblet til, f.eks. `1 / 500`: **en app i Development-status tar maksimalt 500 brukere**. For flere brukere klikker du **Apply for production**, og Dropbox går gjennom appen.
</Warning>

Hvis du befinner deg i en region med begrenset nettverkstilgang, kan det hende du må konfigurere en proxy for å få tilgang til Dropbox. Sett følgende miljøvariabel: `DROPBOX_SYNC_PROXY_URL=http://10.0.0.1:10808`. Det må være en vanlig HTTP/HTTPS-videresendingsproxy, og den må ikke bruke `127.0.0.1`.

### Webhook

Dropbox varsler Overleaf om endringer i Dropbox via en webhook, slik at de vises i Overleaf i løpet av sekunder. Webhooken går til adressen til nettstedet ditt, `${OVERLEAF_SITE_URL}/dropbox/webhook`, og ingen ekstra port er nødvendig, men **Dropbox må kunne nå den fra internett**. Når du legger den til i App Console, kontrollerer Dropbox den med en gang.

Uten en webhook, for eksempel på en server som Dropbox ikke kan nå, sendes endringer i Overleaf fortsatt til Dropbox, men endringer i Dropbox kommer bare tilbake når en bruker klikker *sync this project now* i Dropbox-dialogboksen i editoren.

### Slik fungerer synkroniseringen

* **Tilkobling**: når en bruker kobler til Dropbox-kontoen sin, sendes prosjektene brukeren eier, til Dropbox. Prosjekter som er delt med brukeren, vises i Dropbox ved neste endring.
* **Overleaf til Dropbox**: nye filer, navneendringer, flyttinger, slettinger og nye prosjektnavn sendes med en gang. Endringer i editoren sendes når Overleaf lagrer dem i lagringen sin, noen minutter etter at alle har forlatt prosjektet. For å sende dem tidligere klikker du *sync this project now* i Dropbox-dialogboksen i editoren (én gang per minutt).
* **Dropbox til Overleaf**: nye og endrede filer, nye mapper og slettinger i en prosjektmappe brukes på prosjektet. En ny mappe øverst i appmappen blir et nytt prosjekt. Hvis en prosjektmappe slettes i Dropbox, merkes prosjektet som slettet i Overleaf.
* **Konflikter**: når en fil endres begge steder samtidig, vinner den siste endringen. Dropbox kan beholde den andre versjonen som en *conflicted copy*.
* **Samarbeidspartnere**: samarbeidspartnere som kobler til Dropbox-en sin, får prosjektene som er delt med dem. Brukere med kun lesetilgang og korrekturlesere får prosjektet, men endringene deres i Dropbox synkroniseres ikke tilbake til Overleaf.
* **Ignorerte filer**: filer som Overleaf ikke synkroniserer, som byggeresultater (`.aux`, `.log`, …), `.DS_Store` eller virtuelle Python-miljøer, blir bare liggende i Dropbox.

### Q\&A

<Accordion title="Hvorfor kan ikke en bruker koble til Dropbox-kontoen sin?">
  <strong>Svar:</strong>

  * Prosjekter matches med Dropbox-mapper etter navn, så en bruker som har to prosjekter med samme navn, blir bedt om å gi et av dem nytt navn først.
  * En Dropbox-konto kan bare kobles til én Overleaf-konto.
</Accordion>

<Accordion title="Hvorfor ble en Dropbox-konto koblet fra?">
  <strong>Svar:</strong> Overleaf kobler fra en Dropbox-konto når Dropbox avviser tokenet (for eksempel etter at brukeren har fjernet appen i Dropbox), når Dropbox-en er full, eller når Dropbox har suspendert kontoen. Brukeren kan koble den til igjen når problemet er løst.
</Accordion>

<Accordion title="Kan jeg gi nytt navn til en prosjektmappe i Dropbox?">
  <strong>Svar:</strong> Gi heller prosjektet nytt navn i Overleaf. For Overleaf betyr en navneendring av mappen i Dropbox at prosjektmappen slettes og en ny opprettes, så det gamle prosjektet merkes som slettet, og et nytt prosjekt opprettes fra filene.
</Accordion>


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