Skip to content
Fetching contributors…
Cannot retrieve contributors at this time
177 lines (105 sloc) 6.59 KB


node-sqlite3 - Asynchronous, non-blocking SQLite3 bindings for Node.js 0.2-0.4 (versions 2.0.x), 0.6.13+, 0.8.x, and 0.10.x (versions 2.1.x).

(Can also run in node-webkit if it uses a supported version of Node's engine.)

Build Status npm package version


Note: the module must be installed before use.

var sqlite3 = require('sqlite3').verbose();
var db = new sqlite3.Database(':memory:');

db.serialize(function() {"CREATE TABLE lorem (info TEXT)");

  var stmt = db.prepare("INSERT INTO lorem VALUES (?)");
  for (var i = 0; i < 10; i++) {"Ipsum " + i);

  db.each("SELECT rowid AS id, info FROM lorem", function(err, row) {
      console.log( + ": " +;




See the API documentation in the wiki.


You can use npm to download and install:

  • The latest sqlite3 package: npm install sqlite3

  • GitHub's master branch: npm install

In both cases the module is automatically built with npm's internal version of node-gyp, and thus your system must meet node-gyp's requirements.

It is also possible to make your own build of sqlite3 from its source instead of its npm package (see below).

It is possible to use the installed package in node-webkit instead of the vanilla Node.js, but a rebuild is required before use (see the next section).


Unless building via npm install (which uses its own node-gyp) you will need node-gyp installed globally:

npm install node-gyp -g

The sqlite3 module depends only on libsqlite3. However, by default, an internal/bundled copy of sqlite will be built and statically linked, so an externally installed sqlite3 is not required.

If you wish to install against an external sqlite then you need to pass the --sqlite argument to node-gyp, npm install or the configure wrapper.

./configure --sqlite=/usr/local

Or, using the node-gyp directly:

 node-gyp --sqlite=/usr/local

Or, using npm:

 npm install --sqlite=/usr/local

If building against an external sqlite3 make sure to have the development headers available. Mac OS X ships with these by default. If you don't have them installed, install the -dev package with your package manager, e.g. apt-get install libsqlite3-dev for Debian/Ubuntu. Make sure that you have at least libsqlite3 >= 3.6.

Note, if building against homebrew-installed sqlite on OS X you can do:

./configure --sqlite=/usr/local/opt/sqlite/


Because of ABI differences, only a rebuilt version of sqlite3 can be used in node-webkit.

After the sqlite3 module is installed (according to the previous section), do the following:

  1. Install nw-gyp globally: npm install nw-gyp -g (unless already installed)

  2. Use nw-gyp to rebuild the module:

NODE_WEBKIT_VERSION="0.8.4" # see latest version at
nw-gyp rebuild --target=${NODE_WEBKIT_VERSION}

Remember the following:

  • In the nw-gyp rebuild command, specify the actual target version of your node-webkit. The command must be run in sqlite3's directory (where its package.json resides).

  • After the sqlite3 package is rebuilt for node-webkit it cannot run in the vanilla Node.js (and vice versa).

    • For example, npm test of the node-webkit's package would fail.
    • If you need sqlite3 package both for Node.js and node-webkit, then you should make two separate installations of sqlite3 (in different directories) and rebuild only one of them for node-webkit.

Visit the “Using Node modules” article in the node-webkit's wiki for more details.


To run node-sqlite3 against sqlcipher you need to compile from source by passing build options like:

npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=/usr/

If your sqlcipher is installed in a custom location, say if you installed it with homebrew on OS X you also need to do:

export LDFLAGS="-L`brew --prefix`/opt/sqlcipher/lib"
export CPPFLAGS="-I/`brew --prefix`opt/sqlcipher/include"
npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=`brew --prefix`


mocha is required to run unit tests.

In sqlite3's directory (where its package.json resides) run the following:

npm install mocha
npm test



Thanks to Orlando Vazquez, Eric Fredricksen and Ryan Dahl for their SQLite bindings for node, and to mraleph on Freenode's #v8 for answering questions.

Development of this module is sponsored by MapBox.


node-sqlite3 is BSD licensed.

Jump to Line
Something went wrong with that request. Please try again.