{"id":31656533,"url":"https://github.com/kubex-ecosystem/gdbase","last_synced_at":"2026-05-07T09:36:50.725Z","repository":{"id":298923567,"uuid":"992498643","full_name":"kubex-ecosystem/gdbase","owner":"kubex-ecosystem","description":"Modular, scalable, and automatic database management for modern systems.","archived":false,"fork":false,"pushed_at":"2025-11-30T23:34:46.000Z","size":8395,"stargazers_count":1,"open_issues_count":6,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-12T01:37:06.780Z","etag":null,"topics":["bussiness-rule","data-modeling","database","docker","golang","orquestration"],"latest_commit_sha":null,"homepage":"https://github.com/rafa-mori/gdbase","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/kubex-ecosystem.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"support/.gitleaks.toml","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE.md","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-05-29T08:53:37.000Z","updated_at":"2025-10-11T10:33:01.000Z","dependencies_parsed_at":"2025-06-25T01:36:44.433Z","dependency_job_id":"d397bb90-9f20-46e0-9a01-29a0de4cadb9","html_url":"https://github.com/kubex-ecosystem/gdbase","commit_stats":null,"previous_names":["rafa-mori/gdbase","kubex-ecosystem/gdbase"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/kubex-ecosystem/gdbase","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubex-ecosystem%2Fgdbase","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubex-ecosystem%2Fgdbase/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubex-ecosystem%2Fgdbase/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubex-ecosystem%2Fgdbase/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubex-ecosystem","download_url":"https://codeload.github.com/kubex-ecosystem/gdbase/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubex-ecosystem%2Fgdbase/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32731919,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-07T02:14:30.463Z","status":"ssl_error","status_checked_at":"2026-05-07T02:14:29.405Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["bussiness-rule","data-modeling","database","docker","golang","orquestration"],"created_at":"2025-10-07T14:14:44.825Z","updated_at":"2026-05-07T09:36:50.720Z","avatar_url":"https://github.com/kubex-ecosystem.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"#\n\n![GDBASE Banner](docs/assets/top_banner.png)\n\n[![Go](https://img.shields.io/badge/Go-1.19+-00ADD8?logo=go\u0026logoColor=white)](https://go.dev/)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/kubex-ecosystem/gdbase/blob/main/LICENSE)\n[![Automation](https://img.shields.io/badge/automation-zero%20config-blue)](#features)\n[![Releases](https://img.shields.io/github/v/release/kubex-ecosystem/goforge?include_prereleases)](https://github.com/kubex-ecosystem/goforge/releases)\n[![Build](https://github.com/kubex-ecosystem/gdbase/actions/workflows/kubex_go_release.yml/badge.svg)](https://github.com/kubex-ecosystem/gdbase/actions/workflows/kubex_go_release.yml)\n\n---\n\n**Modular, scalable, and automatic database management for modern systems.**\n\n---\n\n## **Table of Contents**\n\n1. [About the Project](#about-the-project)\n2. [Features](#features)\n3. [Installation](#installation)\n4. [Usage](#usage)\n    - [CLI](#cli)\n    - [Project Structure](#project-structure)\n    - [Configuration](#configuration)\n5. [Roadmap](#roadmap)\n6. [Contributing](#contributing)\n7. [Contact](#contact)\n\n---\n\n## **About the Project**\n\n**GDBASE** is a database management solution developed in Go, designed to be **modular, scalable, and automatic**. It allows zero-configuration by default, but supports advanced customizations via configuration files. It manages local databases, Docker, and multiple databases simultaneously, making it ideal for distributed systems.\n\n---\n\n## **Features**\n\n✨ **Dynamic and automatic configuration**\n\n- Randomly generated passwords stored in the keyring.\n- Automatically adjusts for occupied ports.\n\n🗄️ **Multi-DB support**\n\n- Redis, RabbitMQ, MongoDB, PostgreSQL, and SQLite ready to use.\n\n🏗️ **Modular architecture**\n\n- Models follow the `Model → Repo → Service` pattern.\n- Ensures modularity and organization.\n\n🔐 **SSH tunnel for external databases**\n\n- `gdbase ssh tunnel` securely connects to remote databases via SSH.\n\n⚙️ **Docker orchestration**\n\n- Automatic container generation for portability and easy deployment.\n\n📡 **Monitoring and events**\n\n- Event bus for internal action tracking.\n\n---\n\n## **Installation**\n\nRequirements:\n\n- Go 1.19+\n- Docker (for containerized databases)\n\nClone the repository and build:\n\n```sh\n# Clone the repository\ngit clone https://github.com/kubex-ecosystem/gdbase.git\ncd gdbase\ngo build -o gdbase .\n```\n\n---\n\n## **Usage**\n\n### CLI\n\nStart the main server:\n\n```sh\n./gdbase start\n```\n\nSee all available commands:\n\n```sh\n./gdbase --help\n```\n\n**Main commands:**\n\n| Command      | Function                                             |\n|--------------|-----------------------------------------------------|\n| `start`      | Initializes `gdbase` and sets up all services       |\n| `status`     | Shows status of active databases                    |\n| `config`     | Creates a configuration file for customization      |\n| `ssh tunnel` | Creates a secure tunnel for external DBs via SSH    |\n| `docker`     | Manages Docker containers for databases             |\n\n### Project Structure\n\nThe core implementation follows a clear and modular architecture:\n\n```plaintext\n./\n├── cmd\n│   ├── cli\n│   ├── gen_models.go\n│   ├── models.go\n│   ├── main.go\n│   ├── usage.go\n│   └── wrpr.go\n├── docs\n│   └── assets\n├── go.mod\n├── go.sum\n├── internal\n│   ├── events\n│   ├── models\n│   └── services\n├── tests\n└── version\n```\n\n---\n\n### Configuration\n\nGDBASE can run without any initial configuration, but supports customization via YAML/JSON files. By default, everything is generated automatically on first use.\n\nExample configuration:\n\n```yaml\npostgres:\n  host: localhost\n  port: 5432\n  user: gdbase\n  password: secure\nredis:\n  host: localhost\n  port: 6379\n```\n\n---\n\n## **Roadmap**\n\n- [x] Dynamic and automatic configuration\n- [x] Multi-DB support (Redis, RabbitMQ, MongoDB, PostgreSQL, SQLite)\n- [x] Integrated SSH tunnel\n- [x] Docker orchestration\n- [ ] Plugins for new databases\n- [ ] Web dashboard for monitoring\n\n---\n\n## **Contributing**\n\nContributions are welcome! Feel free to open issues or submit pull requests. See the [Contribution Guide](docs/CONTRIBUTING.md) for more details.\n\n---\n\n## **Contact**\n\n💌 **Developer**:\n[Rafael Mori](mailto:faelmori@gmail.com)\n💼 [Follow me on GitHub](https://github.com/kubex-ecosystem)\nI'm open to collaborations and new ideas. If you found the project interesting, get in touch!\n\n---\n\n**Made with care by the Mori family!** ❤️\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubex-ecosystem%2Fgdbase","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubex-ecosystem%2Fgdbase","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubex-ecosystem%2Fgdbase/lists"}