Go to file

Andrew Bradshaw d42c2f6ce7 SERVER-113428 Refactor abseil to use its own build system (#44952 ) GitOrigin-RevId: 37e8183a7a77c99b628e8efba83a80299ad9e5b4		2025-12-09 21:54:37 +00:00
.cursor/rules	SERVER-114696 Update assert.soon rule in cs-robust-jstest (#44682 )	2025-12-04 17:03:04 +00:00
.devcontainer	SERVER-115105: Upgrade evergreen cli in devcontainer (#44989 )	2025-12-09 17:32:14 +00:00
.github	SERVER-107499 Implement BSON to Extended JSON (in BSON) conversion (#44519 )	2025-12-09 15:58:32 +00:00
.tmp	SERVER-114982: Enable compressed bazel exec log by default (#44882 )	2025-12-08 20:42:56 +00:00
.vscode_defaults	SERVER-114396 raise error message from launch targets script (#44396 )	2025-11-25 16:09:11 +00:00
bazel	SERVER-113428 Refactor abseil to use its own build system (#44952 )	2025-12-09 21:54:37 +00:00
buildfarm	SERVER-103025 delete scons (#34270 )	2025-04-10 03:33:39 +00:00
buildscripts	SERVER-115024 Replace distutils with shutil for Python 3.13 compatibi… (#44926 )	2025-12-09 20:03:42 +00:00
debian	SERVER-107074: Update man pages for 8.2 (#39851 )	2025-08-25 16:54:52 +00:00
distsrc	SERVER-99662 Implmement building msi's in bazel (#33677 )	2025-04-10 01:43:37 +00:00
docs	SERVER-114674 Add support for scheduling antithesis images to run from patch builds (#44821 )	2025-12-08 18:33:28 +00:00
etc	SERVER-113428 Refactor abseil to use its own build system (#44952 )	2025-12-09 21:54:37 +00:00
evergreen	SERVER-114674 Add support for scheduling antithesis images to run from patch builds (#44821 )	2025-12-08 18:33:28 +00:00
jstests	SERVER-115107: Retry on transient transaction error in write_concern_all_commands (#44996 )	2025-12-09 20:04:37 +00:00
modules_poc	SERVER-113428 Refactor abseil to use its own build system (#44952 )	2025-12-09 21:54:37 +00:00
rpm	SERVER-104338: Rename mongodb-enterprise-crypt RPM package (#35845 )	2025-05-06 20:50:50 +00:00
src	SERVER-113428 Refactor abseil to use its own build system (#44952 )	2025-12-09 21:54:37 +00:00
tools	SERVER-114982: Enable compressed bazel exec log by default (#44882 )	2025-12-08 20:42:56 +00:00
x509	SERVER-101468 Update certificate generation to be cross-platform and deterministic (#33814 )	2025-04-10 03:08:20 +00:00
.bazelignore	SERVER-114982: Enable compressed bazel exec log by default (#44882 )	2025-12-08 20:42:56 +00:00
.bazeliskrc	SERVER-111729 use waterfall binaries for custom bazel binary (#42019 )	2025-09-30 22:41:34 +00:00
.bazelrc	SERVER-114982: Enable compressed bazel exec log by default (#44882 )	2025-12-08 20:42:56 +00:00
.bazelrc.local.example	SERVER-99004 Change from build to common in bazelrc so more things can inherit (#30830 )	2025-01-06 22:50:48 +00:00
.bazelrc.sync	SERVER-102364 Periodically check $reduce accumulated depth less than… (#38333 )	2025-08-06 19:22:18 +00:00
.bazelversion	SERVER-111729 use waterfall binaries for custom bazel binary (#42019 )	2025-09-30 22:41:34 +00:00
.clang-format	SERVER-113167 add clang format config for newlines at EOF (#43302 )	2025-10-29 17:08:21 +00:00
.clang-tidy.in	SERVER-113193 apply standard mongo include path (#43328 )	2025-10-30 01:38:04 +00:00
.editorconfig	SERVER-107825: editorconfig for common files (#43105 )	2025-10-29 17:53:05 +00:00
.gdbinit	SERVER-75613 Add GDB pretty printers for immutable data structures	2023-04-21 13:30:50 +00:00
.git-blame-ignore-revs	SERVER-108478 JS formatted by prettier and remove clang-format (#39656 )	2025-08-21 17:27:09 +00:00
.gitattributes	SERVER-100324 Do not automatically merge changes to golden test expected output (#44643 )	2025-12-04 15:24:12 +00:00
.gitignore	SERVER-114982: Enable compressed bazel exec log by default (#44882 )	2025-12-08 20:42:56 +00:00
.lldbinit	SERVER-41168 Add lldb comment to .lldbinit	2019-06-17 10:07:37 -04:00
.mypy.ini	SERVER-72262 Bump Python minimum version to 3.9/3.10	2023-08-02 21:39:07 +00:00
.npmrc	SERVER-100116 Set up rules_lint with eslint (#32036 )	2025-04-09 19:38:20 +00:00
.prettierignore	SERVER-107852 Update README.third_party.md and SBOM on master (#39934 )	2025-09-03 22:21:45 +00:00
.prettierrc	SERVER-108478 JS formatted by prettier and remove clang-format (#39656 )	2025-08-21 17:27:09 +00:00
.udbinit	SERVER-50449 Add gdb helper scripts for UndoDB	2020-09-01 15:48:47 +00:00
AGENTS.md	SERVER-112079 allow AI writes to test files regardless of extension (#42952 )	2025-10-24 12:09:09 +00:00
BUILD.bazel	SERVER-112053 Update folder hierarchy with up-to-date Catalog and Routing modules and components nomenclature (#44331 )	2025-11-24 17:51:16 +00:00
CLAUDE.md	SERVER-112079 Move AI write rules to tool-agnostic AGENTS.md file (#42714 )	2025-10-20 12:14:04 +00:00
CONTRIBUTING.rst	…
CreativeCommons.txt	SERVER-72867 eol-terminate all nonempty text files	2023-04-26 19:19:19 +00:00
LICENSE-Community.txt	SERVER-37651 Fix typo in license files	2018-10-17 13:56:42 -04:00
MODULE.bazel	SERVER-113428 Refactor abseil to use its own build system (#44952 )	2025-12-09 21:54:37 +00:00
MODULE.bazel.lock	SERVER-99754 No longer use cc_shared_library for dynamic library builds (#43165 )	2025-11-24 22:53:45 +00:00
OWNERS.yml	SERVER-114982: Enable compressed bazel exec log by default (#44882 )	2025-12-08 20:42:56 +00:00
README.md	SERVER-111949 Update README to point at mongodb-maintained dockerhub container (#42201 )	2025-10-06 15:09:49 +00:00
README.third_party.md	SERVER-111072 Auto-generated SBOM files [master] (#44910 )	2025-12-08 22:47:50 +00:00
WORKSPACE.bazel	SERVER-111463 Force codeowners to use bazel installed python (#41814 )	2025-09-25 15:45:56 +00:00
copy.bara.sky	SERVER-111300 Allow overrides through merge queue (#41664 ) (#41818 )	2025-09-29 16:24:32 +00:00
cspell.json	SERVER-98435 Initial commit for modules poc (#30573 )	2025-04-09 19:48:20 +00:00
eslint.config.mjs	SERVER-114198 Create a Mongo proxy to manage a pool of connection (#44455 )	2025-12-04 15:23:36 +00:00
jsconfig.json	SERVER-103603: Support .d.ts typings for common "conn" and "db" workflows (#35071 )	2025-04-16 20:01:24 +00:00
package.json	SERVER-101526 Eslint not woking anymore due to missing eslint-plugin-mongodb dependency (#32926 )	2025-04-09 22:59:06 +00:00
pnpm-lock.yaml	SERVER-112646: Set up eslint and node for devcontainer (#42978 )	2025-10-23 14:17:04 +00:00
poetry.lock	SERVER-112841: integrate avro deserialize with $source (#43128 )	2025-10-28 18:16:31 +00:00
poetry_requirements.txt	SERVER-105429 make poetry requrements file (#36472 )	2025-05-23 19:30:39 +00:00
pyproject.toml	SERVER-112841: integrate avro deserialize with $source (#43128 )	2025-10-28 18:16:31 +00:00
sbom.json	SERVER-111072 Auto-generated SBOM files [master] (#44910 )	2025-12-08 22:47:50 +00:00

README.md

MongoDB README

Welcome to MongoDB!

Components

mongod - The database server.
mongos - Sharding router.

Download MongoDB

https://www.mongodb.com/try/download/community
Using homebrew brew tap mongodb/brew
Using docker image docker pull mongodb/mongodb-community-server

Download the MongoDB Shell

https://www.mongodb.com/try/download/shell
Using homebrew brew install mongosh

Building

See Building MongoDB.

Running

For command line options invoke:

$ ./mongod --help

To run a single server database:

$ sudo mkdir -p /data/db
$ ./mongod
$
$ # The mongosh shell connects to localhost and test database by default:
$ ./mongosh
test> help

Installing Compass

You can install compass using the install_compass script packaged with MongoDB:

$ ./install_compass

This will download the appropriate MongoDB Compass package for your platform and install it.

Drivers

Client drivers for most programming languages are available at https://docs.mongodb.com/manual/applications/drivers/.

Bug Reports

See https://github.com/mongodb/mongo/wiki/Submit-Bug-Reports.

Packaging

Packages are created dynamically by the buildscripts/packager.py script. This will generate RPM and Debian packages.

Learn MongoDB

Documentation - https://docs.mongodb.com/manual/
Developer Center - https://www.mongodb.com/developer/
MongoDB University - https://learn.mongodb.com

Cloud Hosted MongoDB

https://www.mongodb.com/cloud/atlas

Forums

https://mongodb.com/community/forums/

Technical questions about using MongoDB.
https://mongodb.com/community/forums/c/server-dev

Technical questions about building and developing MongoDB.

LICENSE

MongoDB is free and the source is available. Versions released prior to October 16, 2018 are published under the AGPL. All versions released after October 16, 2018, including patch fixes for prior versions, are published under the Server Side Public License (SSPL) v1. See individual files for details which will specify the license applicable to each file. Files subject to the SSPL will be noted in their headers.