Dropbox
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
- Open Settings → Server → Storage Providers.
- Select Add Provider → Dropbox.
- Enter a descriptive Name and save.
- Complete the authorization on Dropbox.
- After the browser returns to Easypanel, confirm that the provider shows as connected.
- Select it in a backup configuration and perform a manual run.
- Confirm the expected file in Dropbox.
The provider is not offered in backup forms until OAuth has completed successfully.
Destination paths
The destination path is relative to the Dropbox root available to Easypanel:
production/orders-postgresUse 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
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.
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.
Troubleshooting
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
- 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
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 for shared path and provider removal behavior.