Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tag: 3.6.0
Fetching contributors…

Cannot retrieve contributors at this time

74 lines (52 sloc) 3.177 kb
extends layout
block content
h2 Connections
We may connect to MongoDB by utilizing the `mongoose.connect()` method.
This is the minimum needed to connect the `myapp` database running locally on the default port (27017). We may also specify several more parameters in the `uri` depending on your environment:
See the [mongodb connection string spec]( for more detail.
h3 Options
The `connect` method also accepts an `options` object which will be passed on to the underlying driver. All options included here take precedence over options passed in the connection string.
mongoose.connect(uri, options);
The following option keys are available:
db - passed to the connection db instance
server - passed to the connection server instance(s)
replset - passed to the connection ReplSet instance
user - username for authentication (if not specified in uri)
pass - password for authentication (if not specified in uri)
See the [driver]( for more information about available options.
_Note: The server option `auto_reconnect` is defaulted to true._
_Note: The db option `forceServerObjectId` is set to false and cannot be overridden._
h3 ReplicaSet Connections
The same method is used to connect to a replica set but instead of passing a single `uri` we pass a comma delimited list of `uri`s.
mongoose.connect('mongodb://username:password@host:port/database,mongodb://username:password@host:port,mongodb://username:password@host:port?options...' [, options]);
_NOTE: The `database` need only be specified in one of the `uri`s._
h3 Multiple connections
So far we've seen how to connect to MongoDB using Mongoose's default connection. At times we may need multiple connections open to Mongo, each with different read/write settings, or maybe just to different databases for example. In these cases we can utilize `mongoose.createConnection()` which accepts all the arguments already discussed and returns a fresh connection for you.
var conn = mongoose.createConnection('uri,uri,uri...', options);
h3 Connection pools
Each `connection`, whether created with `mongoose.connect` or `mongoose.createConnection` are all backed by an internal configurable connection pool defaulting to a size of 5. Adjust the pool size using your connection options:
var uri = 'mongodb://localhost/test';
mongoose.createConnection(uri, { server: { poolSize: 10 }});
// or
var uri = 'mongodb://localhost/test?poolSize=10';
h3#next Next Up
Now that we've covered `connections`, let's take a look at how we can break pieces of our functionality out into reusable and shareable [plugins](/docs/plugins.html).
Jump to Line
Something went wrong with that request. Please try again.