Support restoring databases from a local dump file (UI upload)
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 37.4k
- Forks
- 3k
- Avg merge
- 1d 3h
- Merged PRs (30d)
- 73
Description
What problem will this feature address?
Dokploy currently allows restoring a database from backups stored in an S3 Destination.
When migrating an existing app to Dokploy, the backup/dump often already exists outside Dokploy (for example, created from a previous hosting setup). In that case, there is no direct way to restore from that local dump file through Dokploy.
This creates extra friction for migrations because users may need additional manual steps to move/import the dump first.
Describe the solution you'd like
Add support for restoring a database from a local dump file, ideally directly from the UI by uploading a file.
Possible implementation ideas:
Add a local source option in the current Restore dialog (alongside S3 Destination).
Or add a separate action/button like Restore from file / Import dump.
Expected flow:
- User selects database.
- User chooses “Restore from file” (or local source in restore dialog).
- User uploads a supported dump format.
- Dokploy runs restore/import process and shows logs/progress.
This would make migrations into Dokploy much easier.
Describe alternatives you've considered
- Uploading the dump to S3 first and restoring from S3.
- Manually restoring via CLI/container commands outside the Dokploy UI.
Both workarounds add complexity and are less user-friendly for migration scenarios.
Additional context
I’ve seen a similar concept in Coolify docs: Import backups
Open UX question:
Should this be an additional local destination in the Restore dialog or a separate Restore from dump/file button/action?
Will you send a PR to implement it?
Yes
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
The issue names the existing Restore dialog and S3 Destination flow but no files, tests, or entry points. Start by locating that restore flow and trace how uploads, supported dump formats, restore execution, and logs are handled. Done means a user can select a database, upload a supported local dump, run the restore, and see progress or logs in the UI.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- databases, full-stack
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100