{"id":29608173,"url":"https://github.com/trulyronak/qudb","last_synced_at":"2025-07-20T19:02:44.920Z","repository":{"id":42667248,"uuid":"277198080","full_name":"trulyronak/qudb","owner":"trulyronak","description":"quickly start and manage databases","archived":false,"fork":false,"pushed_at":"2023-03-04T05:11:26.000Z","size":3534,"stargazers_count":3,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-21T12:37:31.878Z","etag":null,"topics":["databases","docker","manage-databases","mysql","postgresql","redis"],"latest_commit_sha":null,"homepage":"https://npmjs.com/package/qudb","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trulyronak.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-04T23:07:07.000Z","updated_at":"2022-03-29T06:05:34.000Z","dependencies_parsed_at":"2025-03-13T19:15:18.877Z","dependency_job_id":null,"html_url":"https://github.com/trulyronak/qudb","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/trulyronak/qudb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trulyronak%2Fqudb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trulyronak%2Fqudb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trulyronak%2Fqudb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trulyronak%2Fqudb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trulyronak","download_url":"https://codeload.github.com/trulyronak/qudb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trulyronak%2Fqudb/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266180411,"owners_count":23888742,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["databases","docker","manage-databases","mysql","postgresql","redis"],"created_at":"2025-07-20T19:02:03.326Z","updated_at":"2025-07-20T19:02:44.914Z","avatar_url":"https://github.com/trulyronak.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"qudb\n====\n\nquickly start and manage databases\n\n[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)\n[![Version](https://img.shields.io/npm/v/qudb.svg)](https://npmjs.org/package/qudb)\n[![Downloads](https://img.shields.io/npm/dt/qudb.svg)](https://npmjs.org/package/qudb)\n[![License](https://img.shields.io/npm/l/qudb.svg)](https://github.com/trulyronak/qudb/blob/master/package.json)\n\n### individual command reference\n\n1. [init](docs/init.md)\n2. [start](docs/start.md)\n3. [status / ps](docs/ps.md)\n4. [help](docs/help.md)\n\n### installation\n\nQUDB can be installed by `npm`, or if you don't want to install it, it can be used with `npx`.\n\n\t\tnpm install -g qudb\n\t\tqdb --help\n\t\t\n\t\t# no install\n\t\tnpx qudb --help # replace qdb with npx qudb\n\n### usage\n\n```\n# start up a postgres database\nqdb start postgres\n\n# start up a postgres database and see whats happening\nqdb start postgres\n\n# see running databases\nqudb ps # qdb status also works\n\n# start a database on a specific port\nqdb start postgres -p 3000\n\n# start a database on a specific network\nqdb start postgres --network amazing\n\n# start a database and save data in a specific dir (defaults to ./qudb/data)\nqdb start postgres --data path/to/dir\n\n# start a database with a specific name\nqudb start postgres --name fantastic\n\n# kill a database (terminates process, does not mess with data)\nqudb stop \u003cname\u003e\n\n# nuke a database (no data saved, db stopped, config stays)\nqudb nuke \u003cname\u003e\n\n# start a database with credentials\nqudb start postgres -u root -p securityismypassion\n\n# start a database but pass in environment variables\nqudb start postgres -e \"amazing=true\"\n\n```\n\n### why this exists\n\n- half the projects on the internet assume you have mongo or postgres or mysql or something setup and running\n- legit no one likes to have that on their computer, even less people really want to clean out their databases or keep them up to date or keep them installed\n\n\n### solution\n\n- use docker to make any db you need, using volumes stored at a consistent location to allow for persistence\n- allow for temporary development sessions, where `qudb` will save your data until you want to erase it or whatever\n\n\n### qudb File\n\nYou can also save credentials in a folder so you don't need to remember a name\n\nqudb.yaml\n\n```yaml\nname: my_db\ntype: postgres | redis | mysql (file an issue for more types!\nusername: root\npassword: password\nsave: true\nstore: path to qudb file directory\ndata: ./.qudb/data # default\nexposedPorts:\n  - hostPort: 5432\n    containerPort: 5432\n```\n\nNow, you can streamline your commands - no more name needed\n\n```\nqudb start\nqudb stop\nqudb status\n```\n\n\n### wait, isn't this just a wrapper for docker?\n\nyes indeed! I'm just lazy of looking up the *right* docker command for each db type, and it's getting real frustrating\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrulyronak%2Fqudb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrulyronak%2Fqudb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrulyronak%2Fqudb/lists"}