# Dropbox

URL: /docs/storage-providers/dropbox

Source: https://github.com/easypanel-io/monorepo/blob/main/apps/website/content/docs/storage-providers/dropbox.mdx

Connect Dropbox as an OAuth-based backup destination.



The Dropbox provider uses OAuth, so you do not enter an access token or
password in Easypanel. Creating the provider redirects the browser to Dropbox
to authorize the connection.

## Connect Dropbox [#connect-dropbox]

1. Open **Settings → Server → Storage Providers**.
2. Select **Add Provider → Dropbox**.
3. Enter a descriptive **Name** and save.
4. Complete the authorization on Dropbox.
5. After the browser returns to Easypanel, confirm that the provider shows as
   connected.
6. Select it in a backup configuration and perform a manual run.
7. Confirm the expected file in Dropbox.

The provider is not offered in backup forms until OAuth has completed
successfully.

## Destination paths [#destination-paths]

The destination path is relative to the Dropbox root available to Easypanel:

```text
production/orders-postgres
```

Use a unique path per backup configuration. Database retention deletes older
files in its path, and volume backup synchronizes its path to match the source
volume.

Monitor the connected account's available capacity. A valid OAuth connection
does not guarantee enough space for the next backup.

## Connection lifecycle [#connection-lifecycle]

Easypanel refreshes the Dropbox token in the background. If authorization is
revoked, expires without a successful refresh, or belongs to an account that no
longer has access, backup actions can fail.

Open the provider's actions menu:

* **Edit** changes only the provider name.
* **Disconnect** revokes authorization and keeps the provider entry available
  for reconnection.
* **Connect** starts OAuth again for a disconnected provider.
* **Remove** revokes authorization and deletes the provider configuration.

Disconnected providers are unavailable in new backup and restore forms.

<Callout type="warn">
  Disconnecting or removing the provider does not delete files from Dropbox.
  Existing backup configurations that reference a disconnected or removed
  provider will not run successfully.
</Callout>

## Troubleshooting [#troubleshooting]

### The provider remains disconnected [#the-provider-remains-disconnected]

* Open its actions menu and select **Connect** again.
* Complete OAuth with the intended Dropbox account.
* Make sure the browser returns to the same reachable Easypanel address that
  started authorization.
* Check whether the account or organization blocks third-party applications.

### A backup starts failing after previously working [#a-backup-starts-failing-after-previously-working]

* Reconnect the provider to replace its authorization.
* Check Dropbox capacity and account status.
* Review the Easypanel backup action log for the exact failed path.
* Confirm that the account still has access to previously created files.

### Retention or volume sync cannot remove a file [#retention-or-volume-sync-cannot-remove-a-file]

Check whether the file is locked or otherwise protected by Dropbox behavior.
Use the Dropbox interface to inspect the destination and its deleted-file or
version history before retrying.

See [Storage Providers](/docs/storage-providers) for shared path and provider
removal behavior.