{"id":15154423,"url":"https://github.com/syasyayas/ferretdb","last_synced_at":"2025-09-30T02:30:29.139Z","repository":{"id":186531719,"uuid":"665779809","full_name":"syasyayas/FerretDB","owner":"syasyayas","description":"A truly Open Source MongoDB alternative","archived":false,"fork":true,"pushed_at":"2023-08-14T03:39:18.000Z","size":8273,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-09-27T17:23:05.361Z","etag":null,"topics":["database","document","ferretdb","go","golang","mongo","mongo-db","mongodb","mongodb-database","postgres","postgresql"],"latest_commit_sha":null,"homepage":"www.ferretdb.io","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"FerretDB/FerretDB","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/syasyayas.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null}},"created_at":"2023-07-13T01:52:38.000Z","updated_at":"2023-08-09T16:27:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/syasyayas/FerretDB","commit_stats":null,"previous_names":["syasyayas/ferretdb"],"tags_count":40,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syasyayas%2FFerretDB","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syasyayas%2FFerretDB/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syasyayas%2FFerretDB/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/syasyayas%2FFerretDB/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/syasyayas","download_url":"https://codeload.github.com/syasyayas/FerretDB/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234687254,"owners_count":18871715,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","document","ferretdb","go","golang","mongo","mongo-db","mongodb","mongodb-database","postgres","postgresql"],"created_at":"2024-09-26T17:23:22.688Z","updated_at":"2025-09-30T02:30:23.453Z","avatar_url":"https://github.com/syasyayas.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FerretDB\n\n[![Go Reference](https://pkg.go.dev/badge/github.com/FerretDB/FerretDB/ferretdb.svg)](https://pkg.go.dev/github.com/FerretDB/FerretDB/ferretdb)\n\n[![Go](https://github.com/FerretDB/FerretDB/actions/workflows/go.yml/badge.svg?branch=main)](https://github.com/FerretDB/FerretDB/actions/workflows/go.yml)\n[![codecov](https://codecov.io/gh/FerretDB/FerretDB/branch/main/graph/badge.svg?token=JZ56XFT3DM)](https://codecov.io/gh/FerretDB/FerretDB)\n\n[![Security](https://github.com/FerretDB/FerretDB/actions/workflows/security.yml/badge.svg?branch=main)](https://github.com/FerretDB/FerretDB/actions/workflows/security.yml)\n[![Packages](https://github.com/FerretDB/FerretDB/actions/workflows/packages.yml/badge.svg?branch=main)](https://github.com/FerretDB/FerretDB/actions/workflows/packages.yml)\n[![Docs](https://github.com/FerretDB/FerretDB/actions/workflows/docs.yml/badge.svg?branch=main)](https://github.com/FerretDB/FerretDB/actions/workflows/docs.yml)\n\nFerretDB was founded to become the de-facto open-source substitute to MongoDB.\nFerretDB is an open-source proxy, converting the MongoDB 6.0+ wire protocol queries to SQL -\nusing PostgreSQL or SQLite as a database engine.\n\n## Why do we need FerretDB?\n\nMongoDB was originally an eye-opening technology for many of us developers,\nempowering us to build applications faster than using relational databases.\nIn its early days, its ease-to-use and well-documented drivers made MongoDB one of the simplest database solutions available.\nHowever, as time passed, MongoDB abandoned its open-source roots;\nchanging the license to [SSPL](https://www.mongodb.com/licensing/server-side-public-license) - making it unusable for many open source and early-stage commercial projects.\n\nMost MongoDB users do not require any advanced features offered by MongoDB;\nhowever, they need an easy-to-use open-source document database solution.\nRecognizing this, FerretDB is here to fill that gap.\n\n## Scope and current state\n\nFerretDB is compatible with MongoDB drivers and popular MongoDB tools.\nIt functions as a drop-in replacement for MongoDB 6.0+ in many cases.\nFeatures are constantly being added to further increase compatibility and performance.\n\nWe welcome all contributors.\nSee our [public roadmap](https://github.com/orgs/FerretDB/projects/2/views/1),\na list of [known differences with MongoDB](https://docs.ferretdb.io/diff/),\nand [contributing guidelines](CONTRIBUTING.md).\n\n## Quickstart\n\nRun this command to start FerretDB with PostgreSQL backend:\n\n```sh\ndocker run -d --rm --name ferretdb -p 27017:27017 ghcr.io/ferretdb/all-in-one\n```\n\nAlternatively, run this command to start FerretDB with SQLite backend:\n\n```sh\ndocker run -d --rm --name ferretdb -p 27017:27017 \\\n  -v ./data:/data/ -e FERRETDB_HANDLER=sqlite -e FERRETDB_SQLITE_URL=file:/data/ \\\n  ghcr.io/ferretdb/all-in-one\n```\n\nThis command will start a container with FerretDB, PostgreSQL, and MongoDB Shell for quick testing and experiments.\nHowever, it is unsuitable for production use cases because it keeps all data inside and loses it on shutdown.\nSee our [Docker quickstart guide](https://docs.ferretdb.io/quickstart-guide/docker/) for instructions\nthat don't have those problems.\n\nWith that container running, you can:\n\n- Connect to it with any MongoDB client application using MongoDB URI `mongodb://127.0.0.1:27017/`.\n- Connect to it using MongoDB Shell by just running `mongosh`.\n  If you don't have it installed locally, you can run `docker exec -it ferretdb mongosh`.\n- For PostgreSQL backend, connect to it by running `docker exec -it ferretdb psql -U username ferretdb`.\n  FerretDB uses PostgreSQL schemas for MongoDB databases.\n  So, if you created some collections in the `test` database using any MongoDB client,\n  you can switch to it by running `SET search_path = 'test';` query\n  and see a list of PostgreSQL tables by running `\\d` `psql` command.\n- For the SQLite backend, database files will be created on a host in the `data` directory.\n  You can access them by running `sqlite3 data/\u003cfilename\u003e.sqlite` after some data is inserted into FerretDB.\n\nYou can stop the container with `docker stop ferretdb`.\n\nWe also provide binaries and packages for various Linux distributions,\nas well as [Go library package](https://pkg.go.dev/github.com/FerretDB/FerretDB/ferretdb) that embeds FerretDB into your application.\nSee [our documentation](https://docs.ferretdb.io/quickstart-guide/) for more details.\n\n## Building and packaging\n\nWe strongly advise users not to build FerretDB themselves.\nInstead, use binaries, Docker images, or `.deb`/`.rpm` packages provided by us.\n\nIf you want to package FerretDB for your operating system or distribution,\nthe recommended way to build the binary is to use the `build-release` task;\nsee our [instructions for contributors](CONTRIBUTING.md) for more details.\nFerretDB could also be built as any other Go program,\nbut a few generated files and build tags could affect it.\nSee [there](https://pkg.go.dev/github.com/FerretDB/FerretDB/build/version) for more details.\n\n## Managed FerretDB at cloud providers\n\n- [Civo](https://www.civo.com) (see [here](https://www.civo.com/marketplace/FerretDB)).\n- [Scaleway](https://www.scaleway.com/) (request access [here](https://www.scaleway.com/en/betas/#managed-document-database)).\n\n## Documentation\n\n- [Documentation for users](https://docs.ferretdb.io/).\n- [Documentation for Go developers about embeddable FerretDB](https://pkg.go.dev/github.com/FerretDB/FerretDB/ferretdb).\n\n## Community\n\n- Website and blog: [https://ferretdb.io](https://ferretdb.io/).\n- Twitter: [@ferret_db](https://twitter.com/ferret_db).\n- Mastodon: [@ferretdb@techhub.social](https://techhub.social/@ferretdb).\n- [Slack chat](https://join.slack.com/t/ferretdb/shared_invite/zt-zqe9hj8g-ZcMG3~5Cs5u9uuOPnZB8~A) for quick questions.\n- [GitHub Discussions](https://github.com/FerretDB/FerretDB/discussions) for longer topics.\n- [GitHub Issues](https://github.com/FerretDB/FerretDB/issues) for bugs and missing features.\n- [Open Office Hours meeting](https://calendar.google.com/event?action=TEMPLATE\u0026tmeid=NjNkdTkyN3VoNW5zdHRiaHZybXFtb2l1OWtfMjAyMTEyMTNUMTgwMDAwWiBjX24zN3RxdW9yZWlsOWIwMm0wNzQwMDA3MjQ0QGc\u0026tmsrc=c_n37tquoreil9b02m0740007244%40group.calendar.google.com\u0026scp=ALL)\n  every Monday at 18:00 UTC at [Google Meet](https://meet.google.com/mcb-arhw-qbq).\n\nIf you want to contact FerretDB Inc., please use [this form](https://www.ferretdb.io/contact/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyasyayas%2Fferretdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsyasyayas%2Fferretdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyasyayas%2Fferretdb/lists"}