Database backups should not be this hard. This tool makes it simple.
D

Database backups should not be this hard. This tool makes it simple.

Database backups should not be this hard. This tool makes it simple.

971 stars
N/A forks
N/A contributors

README

Project documentation from GitHub

One Command, One Dump: Database Backups Made Simple

If you've ever managed a database, you know the drill. Backups are essential, but setting them up can be a tangled mess of credential management, format flags, and scheduling scripts. It feels like it shouldn't be this hard. What if you could just point at a database and get a dump with a single, clean command?

That's exactly the problem onedump solves. It's a straightforward command-line tool that strips away the complexity of database backups. No more remembering the arcane syntax for pg_dump or mysqldump flags. You configure your connection once, and from then on, it's just onedump.

What It Does

Onedump is a unified interface for dumping data from various databases. You tell it where your database is and what kind it is (PostgreSQL, MySQL, etc.), and it handles the rest. It uses the standard, battle-tested native dump tools under the hood (like pg_dump), so you get reliable, native-format dumps, but without having to remember each tool's specific incantations.

You define your database connections in a simple config file, and then backing up is as simple as running onedump my_database. It outputs the dump to stdout, ready to be piped to a file, sent to gzip, or uploaded directly to cloud storage.

Why It's Cool

The beauty of onedump is in its simplicity and developer-centric approach.

  • One Config to Rule Them All: Store all your database connection details (host, port, user, password, type) in a single .onedump.json file. No more environment variable juggling or writing connection strings in cron jobs.
  • Database Agnostic: It provides a consistent command for PostgreSQL, MySQL, SQLite, and Redis. You use the same simple onedump command regardless of the backend.
  • Composability: Because it outputs to stdout, it fits perfectly into the Unix philosophy. Pipe it to gzip, ssh, or your backup script of choice. It does one job and does it well.
  • It's Not Magic, It's Practical: It doesn't try to reinvent the wheel or create a new backup format. It's essentially a smart, consistent wrapper around the official tools you already trust. This makes it predictable and easy to adopt.

How to Try It

Getting started takes about a minute. You'll need Node.js installed.

  1. Install it globally via npm:

    np

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Jan 8, 2026