GPG encryption and decryption in node.js by way of the gpg command-line tool
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

GPG Encryption/Decryption in Node.js

travis npm downloads

This module is a wrapper around gpg for use within Node. Node-GPG takes care of spawning gpg, passing it the correct arguments, and piping input to stdin. It can also pipe input in from files and output out to files.

Use Node-GPG if you are considering calling gpg directly from your application.


In order to use Node-GPG, you'll need to have the gpg binary in your $PATH.


npm install gpg


Node-GPG supports both direct calls to GPG with string arguments, and streaming calls for piping input and output from/to files.

See the source for more details.

If a function you need is not implemented, you can call gpg directly with arguments of your choice by calling, argsArray, cb), or gpg.callStreaming(inputFileName, outputFileName, argsArray, cb).


Existing implementations of PGP in Javascript are blocking and unfeasibly slow for server use. In casual testing, encrypting a simple 400-character email to an El-Gamal key took upwards of 11 seconds using openpgpjs and 14 seconds with kbpgp, but takes less than 0.1 seconds with gpg directly.


The following are the major contributors of node-gpg (in no specific order).