Setting up MongoDB on Windows is a straightforward process when you follow the right steps. This guide walks you through downloading, installing, and configuring MongoDB for local development. By the end, you will have a fully functional database ready for your applications.
Downloading MongoDB
The first step requires obtaining the official MongoDB distribution. Navigate to the MongoDB official website and locate the download section for Windows. You must choose the correct version compatible with your operating system architecture, either 64-bit or 32-bit.
Select the MongoDB Community Server, which is the open-source edition suitable for most development and production environments. Ensure you download the MSI installer, as it provides the easiest path for installation on Windows systems. Verify the checksum after download to ensure file integrity.
Installing the MongoDB Server
Once the download completes, run the MSI installer you obtained. Follow the installation wizard, selecting the "Complete" setup type to include all necessary components. You will be prompted to choose a destination folder; the default location is generally recommended for standard setups.
During the installation, you will be asked to select the server type. Choose "MongoDB Server" and ensure the option to install MongoDB as a Windows Service is checked. This allows the database to start automatically with the system, which is crucial for development stability.
Configuring the Data Directory
MongoDB requires a specific folder to store its database files. By default, the service expects this directory to be located at `C:\data\db`. If this path does not exist, the server will fail to start.
Create the `data` folder inside your root directory (`C:\`). Alternatively, you can specify a custom path during the configuration phase. If you choose a different location, you must inform the service using command-line arguments or a configuration file to ensure it points to the correct directory.
Starting and Verifying the Service
After installation, you need to start the MongoDB service. Open the Windows Services manager, find "MongoDB Server," and click "Start." You can also initiate it via the command prompt using `net start MongoDB` if the service name matches.
To verify the installation, open a new command prompt window and type `mongo`. This command launches the MongoDB Shell, the interactive interface for managing databases. Seeing the shell interface indicates that the server is running and accepting connections successfully.
Managing MongoDB Commands
With the shell open, you can run basic commands to confirm functionality. Use `show dbs` to list the default databases. This command demonstrates that the connection is active and the database is operational.
You can exit the shell by typing `exit` or pressing `Ctrl+C`. For daily operations, remember that MongoDB uses a daemon-like architecture where the `mongod` process handles data operations, while the `mongo` shell is used for administrative tasks.
Securing Your Installation
A default MongoDB installation allows unrestricted local access, which is acceptable for development but insecure for production. To enhance security, you should create administrative user accounts.
After starting the `mongod` process, connect to the shell and switch to the `admin` database. Use the `db.createUser` command to define a username and password. Once created, enable authentication in the configuration file to require credentials for all future connections.
Environment Variables and Path Configuration
To run MongoDB commands from any directory in the command prompt, you must add the MongoDB `bin` folder to your system's PATH environment variable. This step eliminates the need to navigate to the installation directory every time you want to use `mongo` or `mongod`.
Access System Properties, click on "Environment Variables," and edit the PATH variable. Append the path to your MongoDB `bin` directory, such as `C:\Program Files\MongoDB\Server\7.0\bin`. Opening a new terminal window will now recognize these commands globally.
