MongoDB Logo <http://www.mongodb.

org/>
Toggle navigation
*
*
*
*
*
*

Docs <http://docs.mongodb.org>
Try It Out <http://try.mongodb.org>
Downloads <http://www.mongodb.org/downloads>
Community <http://www.mongodb.org/get-involved>
Blog <http://blog.mongodb.org>
<javascript:void(0)>

powered by

MongoDB Manual <../../>

* Introduction <../../core/introduction/>
* Installation <../../installation/>
o Install on Linux <../../administration/install-on-linux/>
o Install MongoDB on OS X <../install-mongodb-on-os-x/>
o Install MongoDB on Windows
o Install MongoDB Enterprise <../install-mongodb-enterprise/>
o Getting Started with MongoDB <../getting-started/>
o Generate Test Data <../generate-test-data/>
* MongoDB CRUD Operations <../../crud/>
* Data Models <../../data-modeling/>
* Administration <../../administration/>
* Security <../../security/>
* Aggregation <../../aggregation/>
* Indexes <../../indexes/>
* Replication <../../replication/>
* Sharding <../../sharding/>
* Frequently Asked Questions <../../faq/>
* Reference <../../reference/>
* Release Notes <../../release-notes/>
About <../../about/>
Contents <../../contents/>
Index <../../genindex/>
Formats
* </manual/single/>
* <http://docs.mongodb.org/v2.4/MongoDB-manual.pdf>
* <http://docs.mongodb.org/v2.4/MongoDB-manual.epub>
<https://github.com/mongodb/docs/blob/v2.4/source/tutorial/install-mongodb-on-wi
ndows.txt>
<https://jira.mongodb.org/secure/CreateIssueDetails!init.jspa?pid=10380&issuetyp
e=4&priority=4&summary=Comment+on%3a+%22tutorial/install-mongodb-on-windows%2Etx
t%22>
<../../meta/translation>

* Install MongoDB <../../installation/>>

* Install MongoDB on Windows
Install MongoDB on Windows <#install-mongodb-on-windows>
Platform Support
Starting in version 2.2, MongoDB does not support Windows XP. Please use
a more recent version of Windows to use more recent releases of MongoDB.
Important
If you are running any edition of Windows Server 2008 R2 or Windows 7,
please install a hotfix to resolve an issue with memory mapped files on
Windows <http://support.microsoft.com/kb/2731284>.
Download MongoDB for Windows <#download-mongodb-for-windows>
There are three builds of MongoDB for Windows:
* MongoDB for Windows Server 2008 R2 edition (i.e. 2008R2) only runs
on Windows Server 2008 R2, Windows 7 64-bit, and newer versions of
Windows. This build takes advantage of recent enhancements to the
Windows Platform and cannot operate on older versions of Windows.
* MongoDB for Windows 64-bit runs on any 64-bit version of Windows
newer than Windows XP, including Windows Server 2008 R2 and Windows
7 64-bit.
* MongoDB for Windows 32-bit runs on any 32-bit version of Windows
newer than Windows XP. 32-bit versions of MongoDB are only intended
for older systems and for use in testing and development systems.
32-bit versions of MongoDB only support databases smaller than 2GB.
Tip
To find which version of Windows you are running, enter the following
command in the /Command Prompt/:
wmic os get osarchitecture
1.
Download the latest production release of MongoDB from the MongoDB
downloads page <http://www.mongodb.org/downloads>. Ensure you
download the correct version of MongoDB for your Windows system. The
64-bit versions of MongoDB will not work with 32-bit Windows.
2.
Extract the downloaded archive.
1. In Windows Explorer, find the MongoDB download file, typically
in the default Downloads directory.
2. Extract the archive to C:\ by right clicking on the archive and
selecting /Extract All/ and browsing to C:\.
3.
Optional. Move the MongoDB directory to another location. For
example, to move the directory to C:\mongodb directory:

1.
Go /Start Menu/ > /All Programs/ > /Accessories/.
2.
Right click /Command Prompt/, and select /Run as Administrator/
from the popup menu.
3.
In the /Command Prompt/, issue the following commands:
cd \
move C:\mongodb-win32-* C:\mongodb
Note
MongoDB is self-contained and does not have any other system
dependencies. You can run MongoDB from any folder you choose. You may
install MongoDB in any directory (e.g. D:\test\mongodb)
Run MongoDB <#run-mongodb>
Set Up the Data Directory <#set-up-the-data-directory>
MongoDB requires a /data folder/ <../../reference/glossary/#term-dbpath>
to store its files. The default location for the MongoDB data directory
is C:\data\db. Create this folder using the /Command Prompt/. Go to the
C:\ directory and issue the following command sequence:
md data
md data\db
You can specify an alternate path for data files using the /--dbpath/
option to mongod.exe <../../reference/program/mongod.exe/#bin.mongod.exe>.
Start MongoDB <#start-mongodb>
To start MongoDB, execute from the /Command Prompt/:
C:\mongodb\bin\mongod.exe
This will start the main MongoDB database process. The waiting for
connections message in the console output indicates that the mongod.exe
process is running successfully.
Note
Depending on the security level of your system, Windows will issue a
/Security Alert/ dialog box about blocking some features of
C:\\mongodb\bin\mongod.exe from communicating on networks. All users
should select Private Networks, such as my home or work network and
click Allow access. For additional information on security and MongoDB,
please read the /Security Concepts/ <../../core/security/> page.

Warning
Do not allow mongod.exe
<../../reference/program/mongod.exe/#bin.mongod.exe> to be accessible to
public networks without running in Secure Mode (i.e. auth
<../../reference/configuration-options/#auth>.) MongoDB is designed to
be run in trusted environments and the database does not enable
authentication or Secure Mode by default.
You may specify an alternate path for \data\db with the dbpath
<../../reference/configuration-options/#dbpath> setting for mongod.exe
<../../reference/program/mongod.exe/#bin.mongod.exe>, as in the
following example:
C:\mongodb\bin\mongod.exe --dbpath d:\test\mongodb\data
If your path includes spaces, enclose the entire path in double
quotations, for example:
C:\mongodb\bin\mongod.exe --dbpath "d:\test\mongo db data"
Connect to MongoDB <#connect-to-mongodb>
Connect to MongoDB using the mongo.exe
<../../reference/program/mongo/#bin.mongo> shell. Open another /Command
Prompt/ and issue the following command:
C:\mongodb\bin\mongo.exe
Note
Executing the command start C:\mongodb\bin\mongo.exe will automatically
start the mongo.exe shell in a separate /Command Prompt/ window.
The mongo.exe <../../reference/program/mongo/#bin.mongo> shell will
connect to mongod.exe
<../../reference/program/mongod.exe/#bin.mongod.exe> running on the
localhost interface and port 27017 by default. At the mongo.exe
<../../reference/program/mongo/#bin.mongo> prompt, issue the following
two commands to insert a record in the test /collection/
<../../reference/glossary/#term-collection> of the default test database
and then retrieve that record:
db.test.save( { a: 1 } )
db.test.find()
See also
mongo <../../reference/program/mongo/#bin.mongo> and /mongo Shell
Methods/ <../../reference/method/>. If you want to develop applications
using .NET, see the documentation of C# and MongoDB
<http://docs.mongodb.org/ecosystem/drivers/csharp> for more information.
MongoDB as a Windows Service <#mongodb-as-a-windows-service>
New in version 2.0.
You can set up MongoDB as a /Windows Service/ so that the database will

start automatically following each reboot cycle.

Note
mongod.exe <../../reference/program/mongod.exe/#bin.mongod.exe> added
support for running as a Windows service in version 2.0, and mongos.exe
<../../reference/program/mongos.exe/#bin.mongos.exe> added support for
running as a Windows Service in version 2.1.1.
Configure the System <#configure-the-system>
The following steps, although optional, are good practice.
You should specify two options when running MongoDB as a Windows
Service: a path for the log output (i.e. logpath
<../../reference/configuration-options/#logpath>) and a /configuration
file/ <../../reference/configuration-options/>.
1.
Optional. Create a specific directory for MongoDB log files:
md C:\mongodb\log
2.
Optional. Create a configuration file for the logpath
<../../reference/configuration-options/#logpath> option for MongoDB
in the /Command Prompt/ by issuing this command:
echo logpath=C:\mongodb\log\mongo.log > C:\mongodb\mongod.cfg
Note
Consider setting the logappend
<../../reference/configuration-options/#logappend> option. If you do
not, mongod.exe <../../reference/program/mongod.exe/#bin.mongod.exe>
will delete the contents of the existing log file when starting.
Changed in version 2.2: The default logpath
<../../reference/configuration-options/#logpath> and logappend
<../../reference/configuration-options/#logappend> behavior changed in
the 2.2 release.
Install and Run the MongoDB Service
<#install-and-run-the-mongodb-service>
Run all of the following commands in /Command Prompt/ with
Administrative Privileges:
1.
To install the MongoDB service:
C:\mongodb\bin\mongod.exe --config C:\mongodb\mongod.cfg --install
Modify the path to the mongod.cfg file as needed. For the
/--install/ option to succeed, you /must/ specify a logpath

<../../reference/configuration-options/#logpath> setting or the

/--logpath/ run-time option.
2.
To run the MongoDB service:
net start MongoDB
If you wish to use an alternate path for your dbpath
<../../reference/configuration-options/#dbpath> specify it in the config
file (e.g. C:\mongodb\mongod.cfg) on that you specified in the
/--install/ operation. You may also specify /--dbpath/ on the command
line; however, always prefer the configuration file.
If you have not set up the data directory, /set up the data directory/
<#set-up-data-directory> where MongoDB will store its data files. If the
dbpath <../../reference/configuration-options/#dbpath> directory does
not exist, mongod.exe
<../../reference/program/mongod.exe/#bin.mongod.exe> will not be able to
start. The default value for dbpath
<../../reference/configuration-options/#dbpath> is \data\db.
Stop or Remove the MongoDB Service
<#stop-or-remove-the-mongodb-service>
To stop the MongoDB service:
net stop MongoDB
To remove the MongoDB service:
C:\mongodb\bin\mongod.exe --remove
Install MongoDB on OS X <../install-mongodb-on-os-x/> Install
MongoDB Enterprise <../install-mongodb-enterprise/>
About MongoDB <http://www.mongodb.org/about/>
*
*
*
*

Introduction <http://www.mongodb.org/about/introduction>
User Community <http://www.mongodb.org/about/community>
MongoDB Masters <http://mongodb.org/about/community/masters>
Planet MongoDB <http://planet.mongodb.org>
MongoDB Resources

*
*
*
*

Downloads <http://www.mongodb.org/downloads>
MongoDB Events <http://www.mongodb.com/events>
Slides and Video <http://www.mongodb.com/presentations>
MongoDB Management Service
<https://mms.mongodb.com/?pk_campaign=mongodb-docs-resources-footer>
(docs <http://mms.mongodb.com/help/>)
MongoDB Ecosystem <http://docs.mongodb.org/ecosystem/>

* Drivers and Client libraries

<http://docs.mongodb.org/ecosystem/drivers/>
* Tools and Integration <http://docs.mongodb.org/ecosystem/tools/>
* Platform Integration <http://docs.mongodb.org/ecosystem/platforms/>
* Use Cases <http://docs.mongodb.org/ecosystem/use-cases/>
MongoDB Drivers <http://docs.mongodb.org/ecosystem/drivers/>
* C <http://docs.mongodb.org/ecosystem/drivers/c> (docs
<http://api.mongodb.org/c/current/>)
* C++ <http://docs.mongodb.org/ecosystem/drivers/cpp> (docs
<http://api.mongodb.org/cplusplus/current/>)
* C# <http://docs.mongodb.org/ecosystem/drivers/csharp> (docs
<http://api.mongodb.org/csharp/current/>)
* Erlang <http://docs.mongodb.org/ecosystem/drivers/erlang> (docs
<http://api.mongodb.org/erlang>)
* Haskell <http://hackage.haskell.org/package/mongoDB> (docs
<http://api.mongodb.org/haskell>)
* Java <http://docs.mongodb.org/ecosystem/drivers/java> (docs
<http://api.mongodb.org/java/current>)
* JavaScript <http://docs.mongodb.org/ecosystem/drivers/javascript>
(docs <http://api.mongodb.org/js/current>)
* Perl <http://docs.mongodb.org/ecosystem/drivers/perl> (docs
<https://metacpan.org/module/MongoDB>)
* PHP <http://docs.mongodb.org/ecosystem/drivers/php> (docs
<http://php.net/mongo/>)
* Python <http://docs.mongodb.org/ecosystem/drivers/python> (docs
<http://api.mongodb.org/python/current>)
* Ruby <http://docs.mongodb.org/ecosystem/drivers/ruby> (docs
<http://api.mongodb.org/ruby/current>)
* Scala <http://docs.mongodb.org/ecosystem/drivers/scala> (docs
<http://api.mongodb.org/scala/casbah/current/>)
Copyright 2013 MongoDB, Inc <http://www.mongodb.com>. Licensed under
Creative Commons <http://creativecommons.org/licenses/by-nc-sa/3.0/ >.
MongoDB, Mongo, and the leaf logo are registered trademarks of MongoDB, Inc.
<https://twitter.com/mongodbinc>
<http://www.youtube.com/user/MongoDB>
<https://www.facebook.com/mongodb>
<https://plus.google.com/u/1/101024085748034940765/posts?cfem=1>