{"id":47653507,"url":"https://github.com/autobase-tech/autobase","last_synced_at":"2026-04-05T00:01:33.669Z","repository":{"id":38107217,"uuid":"190206784","full_name":"autobase-tech/autobase","owner":"autobase-tech","description":"Automated database platform for PostgreSQL® - Your own DBaaS.","archived":false,"fork":false,"pushed_at":"2026-04-03T21:39:44.000Z","size":248928,"stargazers_count":4104,"open_issues_count":26,"forks_count":581,"subscribers_count":46,"default_branch":"main","last_synced_at":"2026-04-03T23:24:43.554Z","etag":null,"topics":["auto-failover","autobase","automation","cluster","database","dbaas","high-availibility","patroni","postgres","postgresql","self-hosted"],"latest_commit_sha":null,"homepage":"https://autobase.tech","language":"TypeScript","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/autobase-tech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"vitabaks","patreon":"vitabaks"}},"created_at":"2019-06-04T13:26:17.000Z","updated_at":"2026-04-03T22:56:28.000Z","dependencies_parsed_at":"2024-11-07T11:28:16.167Z","dependency_job_id":"81001394-0841-4bf9-bb45-332b49bbdfa3","html_url":"https://github.com/autobase-tech/autobase","commit_stats":null,"previous_names":["vitabaks/autobase","vitabaks/postgresql_cluster"],"tags_count":27,"template":false,"template_full_name":null,"purl":"pkg:github/autobase-tech/autobase","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autobase-tech%2Fautobase","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autobase-tech%2Fautobase/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autobase-tech%2Fautobase/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autobase-tech%2Fautobase/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/autobase-tech","download_url":"https://codeload.github.com/autobase-tech/autobase/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autobase-tech%2Fautobase/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31419549,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"last_error":"SSL_read: 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":["auto-failover","autobase","automation","cluster","database","dbaas","high-availibility","patroni","postgres","postgresql","self-hosted"],"created_at":"2026-04-02T08:00:43.402Z","updated_at":"2026-04-05T00:01:33.660Z","avatar_url":"https://github.com/autobase-tech.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/github-autobase.png\"\u003e\n\u003c/p\u003e\n\n# Autobase for PostgreSQL® :elephant: :sparkling_heart:\n\n[![Ansible-lint](https://github.com/autobase-tech/autobase/actions/workflows/ansible-lint.yml/badge.svg)](https://github.com/autobase-tech/autobase/actions/workflows/ansible-lint.yml)\n[![Yamllint](https://github.com/autobase-tech/autobase/actions/workflows/yamllint.yml/badge.svg)](https://github.com/autobase-tech/autobase/actions/workflows/yamllint.yml)\n[![Flake8](https://github.com/autobase-tech/autobase/actions/workflows/flake8.yml/badge.svg)](https://github.com/autobase-tech/autobase/actions/workflows/flake8.yml)\n[![Molecule](https://github.com/autobase-tech/autobase/actions/workflows/molecule.yml/badge.svg)](https://github.com/autobase-tech/autobase/actions/workflows/molecule.yml)\n[![GitHub license](https://img.shields.io/github/license/autobase-tech/autobase)](https://github.com/autobase-tech/autobase/blob/main/LICENSE)\n\n**Autobase for PostgreSQL®** is an open-source alternative to cloud-managed databases (DBaaS) such as Amazon RDS, Google Cloud SQL, Azure Database, and others.\n\nThis automated database platform enables you to create and manage production-ready, highly available PostgreSQL clusters. It simplifies the deployment process, reduces operational costs, and makes database management accessible—even for teams without specialized expertise.\n\n**Automate deployment, failover, backups, restore, upgrades, scaling, and more with ease.**\n\nSay goodbye to manual database management 👋\n\n## Documentation\n\nAutobase documentation can be found [here](https://autobase.tech/docs).\n\n## Support\n\nAutobase support packages are described [here](https://autobase.tech/docs/support).\n\n## Quick start\n\nYou have the option to deploy Postgres clusters using the Console (UI), command line, or GitOps.\n\n### Console (UI)\n\nThe Autobase Console (UI) is the recommended method for most users. It is designed to be user-friendly, minimizing the risk of errors and making it easier than ever to set up your PostgreSQL clusters. This method is suitable for both beginners and those who prefer a visual interface for managing their PostgreSQL clusters.\n\nTo run the autobase console, execute the following command:\n\n```\ndocker run -d --name autobase-console \\\n  --publish 80:80 \\\n  --env PG_CONSOLE_AUTHORIZATION_TOKEN=secret_token \\\n  --env PG_CONSOLE_DOCKER_IMAGE=autobase/automation:latest \\\n  --volume console_postgres:/var/lib/postgresql \\\n  --volume /var/run/docker.sock:/var/run/docker.sock \\\n  --volume /tmp/ansible:/tmp/ansible \\\n  --restart=unless-stopped \\\n  autobase/console:latest\n```\n\n\u003e [!NOTE]\n\u003e It is recommended to run the console in the same network as your database servers to enable monitoring of the cluster status.\n\nAlternatively, you can use [Docker Compose](console/README.md).\n\n**Open the Console UI**:\n\nGo to http://localhost:80 (or the address of your server) and use `secret_token` for authorization.\n\n![Cluster creation demo](images/autobase_create_cluster_demo.gif)\n\nRefer to the [Deployment](https://autobase.tech/docs/category/deployment) section to learn more about the different deployment methods.\n\n### Command line\n\n\u003cdetails\u003e\u003csummary\u003eClick here to expand... if you prefer the command line.\u003c/summary\u003e\u003cp\u003e\n\nThe command line mode is suitable for advanced users who require greater flexibility and control over the deployment and management of their PostgreSQL clusters.\nWhile the Console (UI) is designed for ease of use and is suitable for most users, the command line provides powerful options for those experienced in automation and configuration.\n\nNote: All dependencies and source code are bundled into the `autobase/automation` docker image. This means the deployment process comes down to simply launching a container with a few variable overrides.\n\n1. Prepare your inventory\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/autobase-tech/autobase/refs/heads/main/automation/inventory.example \\\n  --output ./inventory\n```\n\nSpecify IP addresses and appropriate connection settings for your environment, such as ansible_user, ansible_ssh_pass, or ansible_ssh_private_key_file.\n\n```bash\nnano ./inventory\n```\n\n2. Prepare your variables\n\nRefer to the default [variables](https://github.com/autobase-tech/autobase/blob/main/automation/roles/common/defaults/main.yml) for all configurable options. Override them as needed using group_vars, host_vars, or directly in the inventory file.\n\n```bash\nmkdir -p ./group_vars\nnano ./group_vars/all.yml\n```\n\n3. Run the deployment command\n\n```bash\ndocker run --rm -it \\\n  -e ANSIBLE_SSH_ARGS=\"-F none\" \\\n  -e ANSIBLE_INVENTORY=/project/inventory \\\n  -v $PWD:/project \\\n  -v $HOME/.ssh:/root/.ssh \\\n  autobase/automation:latest \\\n    ansible-playbook deploy_pgcluster.yml\n```\n\nTip: Start with `deploy_pgcluster` for initial provisioning, then use `config_pgcluster` for further configuration changes.\n\nAlternatively, you can use [Ansible Collection](./automation/README.md)\n\n### How to start from scratch\n\nIf you need to start from the very beginning, you can use the `remove_cluster` playbook.\n\nAvailable variables:\n\n- `remove_postgres`: stop the PostgreSQL service and remove data\n- `remove_etcd`: stop the ETCD service and remove data\n- `remove_consul`: stop the Consul service and remove data\n\n⚠️ Caution: Only use this in non-production or when you’re absolutely sure.\n\n\u003c/p\u003e\u003c/details\u003e\n\n\u003e [!TIP]\n\u003e 📩 Contact us at info@autobase.tech, and our team will help you implement Autobase into your infrastructure.\n\n### Supported setups of Postgres Cluster\n\nFor a detailed description of the cluster components, visit the [Architecture](https://autobase.tech/docs/overview/architecture) page.\n\n![pg_cluster_scheme](images/pg_cluster_scheme.png#gh-light-mode-only)\n![pg_cluster_scheme](images/pg_cluster_scheme.dark_mode.png#gh-dark-mode-only)\n\n## Compatibility\n\nRedHat and Debian based distros.\n\n###### Supported Linux Distributions:\n\n- **Debian**: 11, 12, 13\n- **Ubuntu**: 22.04, 24.04\n- **CentOS Stream**: 9, 10\n- **Oracle Linux**: 8, 9, 10\n- **Rocky Linux**: 8, 9, 10\n- **AlmaLinux**: 8, 9, 10\n\nArchitecture: x86_64 (amd64), aarch64 (arm64).\n\n###### PostgreSQL versions:\n\nall supported PostgreSQL versions\n\n:white_check_mark: tested, works fine: PostgreSQL 10, 11, 12, 13, 14, 15, 16, 17, 18\n\n_Table of results of daily automated testing of cluster deployment:_\n| Distribution | Test result |\n|--------------|:----------:|\n| Debian 12 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_debian12.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_debian12.yml) |\n| Debian 13 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_debian13.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_debian13.yml) |\n| Ubuntu 22.04 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_ubuntu2204.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_ubuntu2204.yml) |\n| Ubuntu 24.04 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_ubuntu2204.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_ubuntu2404.yml) |\n| CentOS Stream 9 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_centosstream9.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_centosstream9.yml) |\n| CentOS Stream 10 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_centosstream10.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_centosstream10.yml) |\n| Oracle Linux 9 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_oracle_linux9.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_oracle_linux9.yml) |\n| Oracle Linux 10 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_oracle_linux10.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_oracle_linux10.yml) |\n| Rocky Linux 9 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_rockylinux9.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_rockylinux9.yml) |\n| Rocky Linux 10 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_rockylinux10.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_rockylinux10.yml) |\n| AlmaLinux 9 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_almalinux9.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_almalinux9.yml) |\n| AlmaLinux 10 | [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/autobase-tech/autobase/schedule_pg_almalinux10.yml?branch=main)](https://github.com/autobase-tech/autobase/actions/workflows/schedule_pg_almalinux10.yml) |\n\n## Project Status\n\nAutobase has been actively developed for over 5 years (since 2019) and is trusted by companies worldwide, including in production environments with high loads and demanding reliability requirements. Our mission is to provide an open-source DBaaS that delivers reliability, flexibility, and cost-efficiency.\n\n**The project will remain open-source forever**, but to ensure its continuous growth and development, we rely on [sponsorship](https://autobase.tech/docs/sponsor). By subscribing to [Autobase packages](https://autobase.tech/docs/support), you gain access to personalized support from the project authors and PostgreSQL experts.\n\n## Star us\n\nIf you find our project helpful, consider giving it a star on GitHub! Your support helps us grow and motivates us to keep improving. Starring the project is a simple yet effective way to show your appreciation and help others discover it.\n\n\u003ca href=\"https://star-history.com/#autobase-tech/autobase\u0026Date\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=autobase-tech/autobase\u0026type=Date\u0026theme=dark\" /\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=autobase-tech/autobase\u0026type=Date\" /\u003e\n    \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=autobase-tech/autobase\u0026type=Date\" /\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n\n## Sponsor this project\n\nBy sponsoring our project, you directly contribute to its continuous improvement and innovation. As a sponsor, you'll receive exclusive benefits, including personalized support, early access to new features, and the opportunity to influence the project's direction. Your sponsorship is invaluable to us and helps ensure the project's sustainability and progress.\n\nBecome a sponsor today and help us take this project to the next level!\n\nSupport our work through [GitHub Sponsors](https://github.com/sponsors/vitabaks)\n\n[![GitHub Sponsors](https://img.shields.io/github/sponsors/vitabaks?style=for-the-badge)](https://github.com/sponsors/vitabaks)\n\nSupport our work through [Patreon](https://www.patreon.com/vitabaks)\n\n[![Support me on Patreon](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Dvitabaks%26type%3Dpatrons\u0026style=for-the-badge)](https://patreon.com/vitabaks)\n\n## License\n\nLicensed under the MIT License. See the [LICENSE](./LICENSE) file for details.\n\n## Author\n\nVitaliy Kukharik (PostgreSQL Expert, Founder Autobase.tech) \\\nvitaliy@autobase.tech\n","funding_links":["https://github.com/sponsors/vitabaks","https://patreon.com/vitabaks","https://www.patreon.com/vitabaks"],"categories":["TypeScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautobase-tech%2Fautobase","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fautobase-tech%2Fautobase","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautobase-tech%2Fautobase/lists"}