Limitations
We don't plan to address those known differences in behavior:
- FerretDB uses the same error names and codes as MongoDB,
but the exact error messages may sometimes be different.
- FerretDB collection names must be valid UTF-8; MongoDB allows invalid UTF-8 sequences.
We consider all other differences in behavior to be problems and want to address them.
Some of them are mentioned below.
You can upvote linked issues to affect our roadmap.
If you encounter any other problem, please join our community to report it.
Wire protocol
All drivers and applications compatible with MongoDB 5.0+ should be compatible with FerretDB.
Administrative commands
Aggregation commands
| Command | Status |
|---|
aggregate | ✅️ Supported |
count | ✅️ Supported |
distinct | ✅️ Supported |
Authentication commands
| Command | Status |
|---|
authenticate | ❌ Not implemented yet |
logout | ✅️ Supported |
saslContinue | ✅️ Supported |
saslStart | ✅️ Supported |
Diagnostic commands
| Command | Status |
|---|
buildInfo | ✅️ Supported |
collStats | ✅️ Supported |
connectionStatus | ✅️ Supported |
connPoolStats | ❌ Not implemented yet |
dataSize | ✅️ Supported |
dbStats | ✅️ Supported |
explain | ✅️ Supported |
ferretDebugError | ✅️ Supported |
getCmdLineOpts | ✅️ Supported |
getLog | ✅️ Supported |
hostInfo | ✅️ Supported |
listCommands | ✅️ Supported |
logApplicationMessage | ❌ Not implemented yet |
ping | ✅️ Supported |
profile | ❌ Not implemented yet |
serverStatus | ✅️ Supported |
validate | ✅️ Supported |
whatsmyuri | ✅️ Supported |
Query commands
| Command | Status |
|---|
bulkWrite | ❌ Not implemented yet |
delete | ✅️ Supported |
find | ✅️ Supported |
findAndModify | ✅️ Supported |
getMore | ✅️ Supported |
insert | ✅️ Supported |
update | ✅️ Supported |
Role management commands
Session commands
User management commands
| Command | Status |
|---|
createUser | ✅️ Supported |
dropAllUsersFromDatabase | ✅️ Supported |
dropUser | ✅️ Supported |
grantRolesToUser | ❌ Not implemented yet |
revokeRolesFromUser | ❌ Not implemented yet |
updateUser | ✅️ Supported |
usersInfo | ✅️ Supported |
Data API
All drivers and applications compatible with Atlas Data API should be compatible with FerretDB.
| Path | Status |
|---|
/action/aggregate | ✅️ Supported |
/action/deleteMany | ✅️ Supported |
/action/deleteOne | ✅️ Supported |
/action/find | ✅️ Supported |
/action/findOne | ✅️ Supported |
/action/insertMany | ✅️ Supported |
/action/insertOne | ✅️ Supported |
/action/updateMany | ✅️ Supported |
/action/updateOne | ✅️ Supported |