{"id":19398387,"url":"https://github.com/quarkiverse/quarkus-couchbase","last_synced_at":"2026-04-01T19:44:50.223Z","repository":{"id":37847798,"uuid":"502107273","full_name":"quarkiverse/quarkus-couchbase","owner":"quarkiverse","description":"Couchbase is an award-winning distributed NoSQL cloud database.","archived":false,"fork":false,"pushed_at":"2026-03-25T20:42:58.000Z","size":437,"stargazers_count":8,"open_issues_count":5,"forks_count":8,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-03-27T13:57:50.087Z","etag":null,"topics":["couchbase","quarkus-extension"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quarkiverse.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":".github/CODEOWNERS","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}},"created_at":"2022-06-10T16:16:59.000Z","updated_at":"2026-03-27T01:39:42.000Z","dependencies_parsed_at":"2023-02-17T10:31:21.045Z","dependency_job_id":"8ed0d1ac-c774-4fbe-82c8-08bb6d0922cf","html_url":"https://github.com/quarkiverse/quarkus-couchbase","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/quarkiverse/quarkus-couchbase","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkiverse%2Fquarkus-couchbase","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkiverse%2Fquarkus-couchbase/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkiverse%2Fquarkus-couchbase/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkiverse%2Fquarkus-couchbase/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quarkiverse","download_url":"https://codeload.github.com/quarkiverse/quarkus-couchbase/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkiverse%2Fquarkus-couchbase/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31047425,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-27T09:35:52.079Z","status":"ssl_error","status_checked_at":"2026-03-27T09:35:20.916Z","response_time":164,"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":["couchbase","quarkus-extension"],"created_at":"2024-11-10T11:05:58.557Z","updated_at":"2026-04-01T19:44:50.215Z","avatar_url":"https://github.com/quarkiverse.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/quarkiverse/quarkus-couchbase/master/docs/modules/ROOT/assets/images/quarkus.svg\" width=\"67\" height=\"70\" \u003e\n\u003cimg src=\"https://raw.githubusercontent.com/quarkiverse/quarkus-couchbase/master/docs/modules/ROOT/assets/images/plus-sign.svg\" height=\"70\" \u003e\n\u003cimg src=\"https://raw.githubusercontent.com/quarkiverse/quarkus-couchbase/master/docs/modules/ROOT/assets/images/couchbase-filled.svg\" height=\"70\" \u003e\n\n# Quarkus Couchbase\n\u003c/div\u003e\n\u003cbr\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --\u003e\n[![All Contributors](https://img.shields.io/badge/all_contributors-3-orange.svg?style=flat-square)](#contributors-)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:END --\u003e\n[![Version](https://img.shields.io/maven-central/v/io.quarkiverse.couchbase/quarkus-couchbase?logo=apache-maven\u0026style=flat-square)](https://search.maven.org/artifact/io.quarkiverse.couchbase/quarkus-couchbase)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square)](https://opensource.org/licenses/Apache-2.0)\n[![Build](https://github.com/quarkiverse/quarkus-couchbase/actions/workflows/build.yml/badge.svg)](https://github.com/quarkiverse/quarkus-couchbase/actions/workflows/build.yml)\n\n\u003c/div\u003e\nIntegrates Couchbase into Quarkus.\n\nThis extension is currently in beta status.  It supports:\n\n- Dependency injecting a Couchbase `Cluster`.\n- Connecting to a cluster using TLS in native mode (either with the packaged Capella certificate, or a path to a custom one specified with `quarkus.couchbase.security.trustCertificate`)\n- Configuring the Cluster through `application.properties`.  Currently, a minimal set of configuration options is provided.\n- A dev service that starts a Couchbase server in a Docker container. With this you can develop your Quarkus app without having to install Couchbase on your machine.\n- GraalVM/Mandrel/native-image.\n- KV, Query, Transactions, Analytics, Search and Management operations.\n- Micrometer metrics using `quarkus-micrometer`\n- SmallRye Health checks (Readiness) using `quarkus-smallrye-health`\n\nPlease try it out and provide feedback, ideas and bug reports [on Github](https://github.com/quarkiverse/quarkus-couchbase/issues).\n\n## Native Image\nAll main Cluster operations have been tested with our internal testing tools, however the extension remains in beta and some features may be missing or not be fully supported.\n\n## Usage\nAdd it to your project:\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003eio.quarkiverse.couchbase\u003c/groupId\u003e\n  \u003cartifactId\u003equarkus-couchbase\u003c/artifactId\u003e\n  \u003cversion\u003e1.3.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nProvide the Couchbase configuration in `application.properties`:\n```properties\nquarkus.couchbase.connection-string=localhost\nquarkus.couchbase.username=username\nquarkus.couchbase.password=password\n```\nTo disable TestContainers, add:\n```properties\nquarkus.devservices.enabled=false\n```\n\nNow you can @Inject a Couchbase `Cluster` into your project:\n\n```java\n@Path(\"/couchbase\")\npublic class TestCouchbaseResource {\n    @Inject\n    Cluster cluster;\n\n    @GET\n    @Produces(MediaType.TEXT_PLAIN)\n    @Path(\"/test\")\n    public String run() {\n        // Get a reference to a particular Couchbase bucket and its default collection\n        var bucket = cluster.bucket(\"travel-sample\");\n        var collection = bucket.defaultCollection() ;\n\n        // Upsert a new document\n        collection.upsert(\"test\", JsonObject.create().put(\"foo\", \"bar\"));\n\n        // Fetch and print a document\n        var doc = bucket.defaultCollection().get(\"test\");\n        System.out.println(\"Got doc \" + doc.contentAsObject().toString());\n\n        // Perform a N1QL query\n        var queryResult = cluster.query(\"select * from `travel-sample` where url like 'http://marriot%' and country = 'United States';\");\n\n        queryResult.rowsAsObject().forEach(row -\u003e {\n            System.out.println(row.toString());\n        });\n\n        return \"success!\";\n    }\n}\n```\n\nAnd test http://localhost:8080/couchbase/test.\n\n## Additional Configuration\nPlease refer to the [docs](https://github.com/quarkiverse/quarkus-couchbase/blob/main/docs/modules/ROOT/pages/configuration.adoc) for additional configuration options.\n\n## Limitations\nThe Cluster configuration options are limited cluster credentials, and micrometer metrics emission rate.  \nAdditional Cluster connections can be created and configured using `Cluster.connect(...)`, however not all code paths have been tested and are therefore not officially supported.\n\n## License\nAll the files under `nettyhandling` directories, both in the `runtime` and `deployment` modules are\ntaken as-were or modified from the official [netty](https://github.com/quarkusio/quarkus/tree/main/extensions/netty) extension.\nCouchbase does not intend copyright infringement or claim ownership over these files or their content.\n\n## Contributors ✨\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://programmatix.github.io/Words/projects\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/795437?v=4?s=100\" width=\"100px;\" alt=\"Graham Pople\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eGraham Pople\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/quarkiverse/quarkus-couchbase/commits?author=programmatix\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"#maintenance-programmatix\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/emilienbev\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/44171454?v=4?s=100\" width=\"100px;\" alt=\"Emilien Bevierre\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eEmilien Bevierre\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/quarkiverse/quarkus-couchbase/commits?author=emilienbev\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"#maintenance-emilienbev\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/mikereiche\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/48999328?v=4?s=100\" width=\"100px;\" alt=\"Michael Reiche\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eMichael Reiche\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/quarkiverse/quarkus-couchbase/commits?author=mikereiche\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquarkiverse%2Fquarkus-couchbase","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquarkiverse%2Fquarkus-couchbase","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquarkiverse%2Fquarkus-couchbase/lists"}