README.md

Get Started with the MongoDB Go 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 Go 1.25.1 or later installed in your development environment.

Installation

Clone this repository:

git clone https://github.com/mongodb/mongodb-code-examples

Navigate into the go/hello-world project directory:

cd mongodb-code-examples/go/hello-world

If you are creating this sample project from scratch, initialize the Go module and add the MongoDB Go Driver. These commands create go.mod and go.sum:

go mod init github.com/mongodb/mongodb-code-examples/go/hello-world
go get go.mongodb.org/mongo-driver/v2/mongo
go mod tidy

Download the module dependencies:

go mod download

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

go run .

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" : ObjectId("..."), "name" : "Wireless Mouse", "category" : "Electronics", "price" : NumberDecimal("24.99"), "tags" : ["wireless", "usb", "ergonomic"] }

The application prints the result in MongoDB Shell-style format, preserving MongoDB types such as ObjectId and NumberDecimal.

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.