Introduction
What TeselaDB is, which part of MongoDB it covers and how this documentation is organised.
TeselaDB is a distributed document database. It stores BSON documents, speaks the MongoDB 9.0 protocol and splits
every collection into ranges that are replicated across the nodes of the cluster. Your applications connect with the
official MongoDB drivers and with mongosh, without changing any code except the connection string.
What you get when you start it
- A single binary,
teseladb, that acts as node, router and administration tool. - Every node is the same: there are no config servers or helper processes.
- TLS and users from the first start. The first node creates the cluster certificate authority and the
rootuser. - Every collection is split into key ranges. A range splits when it holds more than 64 MiB of live data or receives too many operations, and its replicas move between nodes to spread the load.
Which part of MongoDB it covers
TeselaDB implements the MongoDB 9.0 protocol: CRUD, aggregations, indexes, transactions, change streams, text and vector search, users and roles. The full list of commands, operators and stages, with their status, is in Compatibility, and the differences in behaviour are in Differences with MongoDB.
How the documentation is organised
| Group | What for |
|---|---|
| Get started | Install, start a node, connect and form your first cluster. |
| Develop | What your application does: documents, queries, indexes, transactions and search. |
| Operate | Production, nodes, backups, sharding and metrics. |
| Security | Certificates, authentication, users, encryption and auditing. |
| Concepts | How it works inside: ranges, replicas and consistency. |
| Reference | The CLI, the ports, the REST API, the MCP server and the differences with MongoDB. |
If this is your first time, follow the order of this group: Install, Your first node, Connect and Your first cluster.