Distributed peer-to-peer database on IPFS
JavaScript Other
Latest commit 7fc9f2d Jan 17, 2017 @haadcode 0.16.1



npm version CircleCI Status Project Status

Distributed, peer-to-peer database on IPFS.

orbit-db is a serverless, distributed, peer-to-peer database. orbit-db uses IPFS as its data storage and IPFS Pubsub to automatically sync databases with peers. It's an eventually consistent database that uses CRDTs for conflict-free database merges making orbit-db and excellent choice for offline-first applications.

Data in orbit-db can be stored in a

This is the Javascript implementation and it works both in Node.js and Browsers.

Table of Contents


npm install orbit-db ipfs-daemon
const IPFS = require('ipfs-daemon/src/ipfs-node-daemon')
const OrbitDB = require('orbit-db')

const ipfs = new IPFS()

ipfs.on('error', (e) => console.error(e))
ipfs.on('ready', (e) => {
  const orbitdb = new OrbitDB(ipfs)

  const db = orbitdb.eventlog("feed name")

  db.add("hello world")
    .then(() => {
      const latest = db.iterator({ limit: 5 }).collect()
      console.log(JSON.stringify(latest, null, 2))

For more details, see examples for kvstore, eventlog, feed, docstore and counter.


See API documentation for the full documentation.


Install dependencies

git clone https://github.com/haadcode/orbit-db.git
cd orbit-db
npm install

Browser example

npm run build:examples
npm run examples:browser

Check the code in examples/browser/browser.html.

Node.js example

npm run examples:node


Check the code in examples/eventlog.js and run it with:

LOG=debug node examples/eventlog.js


Check the code in examples/keyvalue.js and run it with:

LOG=debug node examples/keyvalue.js


Run Tests

npm test


npm run build


node examples/benchmark.js


Check out a visualization of the data flow at https://github.com/haadcode/proto2 or a live demo: http://celebdil.benet.ai:8080/ipfs/Qmezm7g8mBpWyuPk6D84CNcfLKJwU6mpXuEN5GJZNkX3XK/.


  • list of modules used
  • orbit-db-pubsub
  • crdts
  • ipfs-log


I would be happy to accept PRs! If you want to work on something, it'd be good to talk beforehand to make sure nobody else is working on it. You can reach me on Twitter @haadcode or on IRC #ipfs on Freenode, or in the comments of the issues section.

A good place to start are the issues labelled "help wanted" or the project's status board.


MIT ©️ 2016 Haadcode