README.md

Get Started with the MongoDB Node.js Driver

This sample application connects to a MongoDB deployment, seeds a small set of sample product documents, and retrieves one of them. Because the app inserts its own data, you don't need to load an external dataset.

Prerequisites

Before you begin, complete the Atlas Get Started guide to create a free Atlas deployment and save your database user credentials.

You also need the following components installed in your development environment:

• Node.js v16.20.1 or later
• npm

Installation

Clone this repository:

git clone https://github.com/mongodb/docs-get-started

Navigate into the node/hello-world project directory and install dependencies:

cd docs-get-started/node/hello-world
npm install

Connect to MongoDB

Set your connection string as an environment variable, replacing <connection string uri> with your connection string:

export MONGODB_URI="<connection string uri>"

Run the Application

node index.js

When you run the app, it inserts a few product documents into the get_started.products collection, then queries and prints one of them:

{
  _id: ...,
  name: 'Wireless Mouse',
  category: 'Electronics',
  price: 24.99,
  tags: [ 'wireless', 'usb', 'ergonomic' ]
}

You can run the app more than once. It clears the collection before each run, so the results stay consistent.

If you encounter an error or see no output, verify that you set the MONGODB_URI environment variable correctly.