The OrbitDB Field Manual
An end-to-end tutorial, an in-depth look at OrbitDB's architecture, and even some philosophical musings about decentralization and the distributed industry. From the creators of OrbitDB.
What's in the book?
The book opens with an introduction that gives an overview of the promises and risks of the distributed space, and describes OrbitDB and its use cases at a high level.
Next, Thinking Peer to Peer is a collection of essays that approach peer-to-peer engineering from a more intellectual and philosophical perspective. It is light on code and heavy on ideas. It is also open for community members to contribute essays of their own, pending editorial review.
Then, The Architecture of OrbitDB covers in-depth, in a more reference style, the structured and architecture of OrbitDB. It includes a description of
ipfs-log, the core of OrbitDB, the data
stores and finally how the
orbit-db library brings it all together into a single, cohesive package that works both in the browser and on the command line.
What comes next? provides some guidance and suggestions about subsequent topics you should explore. This section serves as a launch pad to further your understanding of how our distributed future will be built.
And after all that, we have a chapter on how you might write custom Stores in OrbitDB in Customizing OrbitDB, written in the form of a second Tutorial, that is based on our first chapter.
How to read this book
While this book is best consumed by reading cover-to-cover, we understand that your time is valuable and you want to get the most out of it in the shortest amount of time. Here are some suggestions to digest the information efficiently.
If you are a technical person and want to use OrbitDB to build distributed, peer-to-peer applications, start with Part 1: The tutorial, move to Part 3: The Architecture of OrbitDB, and then read chapters from Part 2 and Part 4 as necessary to fill in any knowledge gaps you may have.
After reading Part 1, Part 3 and Part 2, you are equipped to read Part 5: Customizing OrbitDB.
If you do not want to write code, but instead want to understand peer-to-peer systems and architectures at a higher level, you should be able to get away with only reading Part 2: Thinking Peer to Peer, and then moving on to Part 4, followed by Part 3.
Please note that we may repeat ourselves in different parts of the book. This is intentional because we cannot guarantee people will read the sections of the book in order. Please skim any sections that you already feel like you understand.
Getting the book
Here you can download a copy of the book in the following free formats:
Gaps and out-of-date sections
OrbitDB is an alpha phase software in an alpha industry. A risk of this fact is, that documentation can quickly become out-of-date and be filled with errors.
Mark Henderson (@aphelionz) is the maintainer and lead author of the OrbitDB field manual. However, this work is built upon the efforts of many other people:
This is a living, community-based document, which means it is for and can include you.
- give feedback on, or request modifications to, the tutorial;
- submit an essay for inclusion in the "Thinking Peer to Peer" section.
To do so you are welcome to create a pull request.
Please look at and follow the Code of Conduct.
Pandoc to convert markdown to other formats.
- Make your edits in the markdown files.
npm run lintto make sure your edits meet linting standards.
npm run buildto populate the
- Manually audit the
distoutput to ensure no errors were made.
- Create your PR!
The OrbitDB Field Manual is released under the Creative Commons Attribution-NonCommercial 4.0 International License by Haja Networks Oy.