{"id":46849714,"url":"https://github.com/mirzakhany/dbctl","last_synced_at":"2026-03-10T16:29:21.769Z","repository":{"id":59047688,"uuid":"535073652","full_name":"mirzakhany/dbctl","owner":"mirzakhany","description":"DBCTL is a tool designed to make running ephemeral databases in a Docker container easy and fast.","archived":false,"fork":false,"pushed_at":"2025-08-21T19:14:05.000Z","size":7227,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-21T21:52:37.704Z","etag":null,"topics":["database","golang","postgresql","redis","testing"],"latest_commit_sha":null,"homepage":"https://dbctl.readthedocs.io/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mirzakhany.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2022-09-10T17:44:06.000Z","updated_at":"2025-08-21T19:12:54.000Z","dependencies_parsed_at":"2025-08-21T21:09:53.306Z","dependency_job_id":"a86b7c3f-612d-4061-9695-f8895de36399","html_url":"https://github.com/mirzakhany/dbctl","commit_stats":null,"previous_names":[],"tags_count":52,"template":false,"template_full_name":null,"purl":"pkg:github/mirzakhany/dbctl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirzakhany%2Fdbctl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirzakhany%2Fdbctl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirzakhany%2Fdbctl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirzakhany%2Fdbctl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mirzakhany","download_url":"https://codeload.github.com/mirzakhany/dbctl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirzakhany%2Fdbctl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30342174,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T15:55:29.454Z","status":"ssl_error","status_checked_at":"2026-03-10T15:54:58.440Z","response_time":106,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["database","golang","postgresql","redis","testing"],"created_at":"2026-03-10T16:29:21.045Z","updated_at":"2026-03-10T16:29:21.764Z","avatar_url":"https://github.com/mirzakhany.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DBCTL\n\n## Description\nDBCTL is a tool designed to make running a database in a Docker container easy and fast. It offers the following features:\n\n- Run a database with applied migration files and sample data.\n- Access the connection URL and use your preferred tools to connect to the database.\n- Launch a user interface (UI) for managing the database, if available.\n- Enable users to quickly run tests in a fresh database.\n- Cleanup databases once you're finished using them!\n\n#### DBCTL is not intended for running databases in production. Its primary purpose is to simplify testing and practice with no hassle.\n\n## Install\nTo install `dbctl` from it source:\n\n```shell\ngo install github.com/mirzakhany/dbctl@latest\n```\n\n### Using docker\n```shell\n docker run -lt --rm -v /var/run/docker.sock:/var/run/docker.sock  dbctl:latest /dbctl [options] [args]\n```\n\nNote: in none root installation of docker `docker.sock` is in `$HOME/.docker/run/docker.sock`\n\nYou can also download a prebuilt binary from [releases](https://github.com/mirzakhany/dbctl/releases) page!\n\n\nPlease Check the [docs](https://dbctl.readthedocs.io) for usage.\n\n\n### Todo\n\n- [x] Setup and run postgres database\n- [x] Setup and run redis\n- [x] A web base UI for Postgres\n- [ ] Setup and run MongoDB\n- [ ] Support lua lang for redis in fixtures and migration scripts\n- [ ] Support for js in fixtures and migration scripts\n- [ ] Utilize golang templates to generate sample data.\n- [x] API server to let clients create databases\n- [x] Golang client\n- [x] Python client\n- [ ] JS client\n\n\n## Contributing\nWe welcome any and all contributions! Here are some ways you can get started:\n1. Report bugs: If you encounter any bugs, please let us know. Open up an issue and let us know the problem.\n2. Contribute code: If you are a developer and want to contribute, follow the instructions below to get started!\n3. Suggestions: If you don't want to code but have some awesome ideas, open up an issue explaining some updates or improvements you would like to see!\n4. Documentation: If you see the need for some additional documentation, feel free to add some!\n\n## Instructions\n1. Fork this repository\n2. Clone the forked repository\n3. Add your contributions (code or documentation)\n4. Commit and push\n5. Wait for pull request to be merged\n\n\n## Supporters\n\nJetBrains generously granted me a year of their open-source support licenses to work on this project.\n\n\u003cimg src=\"https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.png\" width=\"100\" alt=\"JetBrains Logo (Main) logo.\"\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirzakhany%2Fdbctl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmirzakhany%2Fdbctl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirzakhany%2Fdbctl/lists"}