Need help with node-ottoman?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

205 Stars 88 Forks Apache License 2.0 160 Commits 39 Opened issues


Node.js ODM for Couchbase

Services available


Need anything else?

Contributors list

CI codecov npm version Commitizen friendly License


Ottoman is an ODM built for Couchbase and Node.js.

Ottoman's goal is to provide a better development experience while using Couchbase, bringing to developers a reliable tool to build systems that are easy to design, maintain, and scale.


npm install ottoman

That's it, you are ready to use Ottoman.

Dependencies Matrix

Supported version are:

| Ottoman | Nodejs | Couchbase SDK | Couchbase Server | ----------- | ----------- | --------------- | ----------------- | ^2.0.0 | ^8.0.0 | ^3.0.0 | ^6.5.0

Notice: make sure you are using supported versions

Getting started

import { connect, model } from "ottoman";
connect("couchbase://localhost/[email protected]:password");

const User = model('User', { name: String });

const user = new User({name:'Jane Doe'}); => console.log('Nice Job!'));

Ottoman v2 main goals

  • To add support to Couchbase SDK 3.
  • To add typescript support.
  • To have a powerful query builder built-in.
  • To allow adding indexes to improve queries performance.
  • To have extendable Schemas using statics, methods, hooks.
  • To have Pluggable Schemas.


To check out

and docs, visit


For questions and support please use the official forum or contact community.


Please make sure to read the Issue Reporting Checklist before opening an issue.


Detailed changes for each release are documented in the release notes.

Stay In Touch


Please make sure to read the

Contributing Guide
before making a pull request. Thank you to all the people who already contributed to Couchbase Ottoman!

Guide for Developers

  1. Install Couchbase Server Using Docker.

  2. Get the repo and install dependencies

$ git clone
$ cd node-ottoman
$ yarn install
  1. Available scripts
$ yarn dev
$ yarn build
$ yarn lint
$ yarn test
$ yarn test --coverage
$ yarn docs
$ yarn docs:dev

Check results on http://localhost:8091/ couchbase web client

Deploying Ottoman to NPM

  • Pull master branch from repo
  • yarn install
  • ensure version number is bumped
  • yarn build
  • yarn is:ready
  • npm publish (--tag alpha or --tag beta)


© Copyright 2013 Couchbase Inc.

Licensed under the Apache License, Version 2.0. See the Apache 2.0 license.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.