npm Travis Gitter FOSSA Status

GUN is a realtime, distributed, offline-first, graph database engine. Doing 15M+ ops/sec in just ~12KB gzipped.

Warning: We're merging 0.5 branch into Master, you may experience some hiccups - please report them!


  • Realtime - It may be trivial to get realtime updates with or something, but what you do not get is state synchronization. GUN does this for you out of the box, assuring that two users' simultaneous updates won't concurrently break each other.
  • Distributed - GUN is peer-to-peer by design, meaning you have no centralized database server to maintain or that could crash. This lets you sleep through the night without worrying about database DevOps - we call this "NoDB". From that, you can build decentralized, federated, or centralized apps.
  • Offline-first - GUN works even if your internet or cell reception doesn't. Users can still plug away and save data as normal, and then when the network comes back online GUN will automatically synchronize all the changes and handle any conflicts for you.
  • Graph - Most databases force you to bend over backwards to match their storage constraints. But graphs are different, they let you have any data structure you want. Whether that be traditional tables with relations, document oriented trees, or tons of circular references. You choose.


  • Try the interactive tutorial in the browser (5min ~ average developer).
  • Or run the NodeJS examples npm install gun && cd node_modules/gun && npm start (5min ~ average developer).

Note: If you don't have node or npm, read this first. If the npm command line didn't work, you may need to mkdir node_modules first or use sudo.

  • An online demo of the examples are available here:
  • Or write a quick app: (try now in jsbin)
    <script src=""></script>
    // var Gun = require('gun'); // in NodeJS
    // var Gun = require('gun/gun'); // in React
    var gun = Gun();

gun.get('mark').put({ name: "Mark", email: "[email protected]", });

gun.get('mark').on(function(data, key){ console.log("update:", data); });

- See this [module for GraphQL support](
## Support

 - Help support development: !
 - Ask questions: ?
 - Chat with us: .

## Documentation
 - [API reference](
 - [**A must read crash course on using GUN**](
 - [Introductory Guide]( 
 - [What tradeoffs does GUN make]( It is an AP system, so banking apps aren't a good fit.
 - [How the Conflict Resolution algorithm works](
 - Check out and add example code [snippets]( —including micro-modules— to address specific situations.
 - Loose [roadmap](

## Deploy

To quickly spin up a Gun test server for your development team, utilize either [Heroku]( or [Docker]( or any variant thereof [Dokku](, [](, [](, etc. !

### [Heroku](



git clone
cd gun
heroku create
git push -f heroku HEAD:master

Then visit the URL in the output of the 'heroku create' step, in a browser.

npm install -g now
now --npm amark/gun

Then visit the URL in the output of the 'now --npm' step, in your browser.


Docker Automated buil Docker Pulls Docker Stars

Pull from the Docker Hub . Or:

docker run -p 8080:8080 gundb/gun

Or build the Docker image locally:

git clone
cd gun
docker build -t myrepo/gundb:v1 .
docker run -p 8080:8080 myrepo/gundb:v1

Or, if you prefer your Docker image with metadata labels (Linux/Mac only):

npm run docker
docker run -p 8080:8080 usenameHere/gun:git

Then visit http://localhost:8080 in your browser.




GUN is designed to be as minimal as possible, with any additional functionality being provided via modules. Please refer to the modules page for a list of existing extensions. Please refer to the gun-extensions repo to see what extensions have been requested or to request an extension.

How can I help make gun even more awesome?


Designed with ♥ by Mark Nadal, the gun team, and many amazing contributors. Liberally licensed under Zlib / MIT / Apache 2.0.

FOSSA Status


Thanks to the following people who have contributed to GUN, via code, issues, or conversation (this list has quickly become tremendously behind! We'll probably turn this into a dedicated wiki page so you can add yourself):

agborkowski; :star:alanmimms; alexlafroscia; anubiann00b; BrockAtkinson (brunch config); bromagosa; Brysgo (GraphQL); coolaj86; d-oliveros, danscan; forrestjt (file.js); gedw99; HelloCodeMing; JosePedroDias (graph visualizer); JuniperChicago (cycle.js bindings); jveres (todoMVC); kristianmandrup (edge); ndarilek; onetom; phpnode; PsychoLlama; RangerMauve (schema); robertheessels (gun-p2p-auth); riston; rootsical; rrrene; sbeleidy; :star:Sean Matheson (Observable/RxJS/Most.js bindings); ssr1ram; Stefdv (Polymer/web components); sjones6 (VueJS); Xe; zot; ayurmedia;

This list of contributors was manually compiled and alphabetically sorted. If we missed you, please submit an issue so we can get you added!


Also see the current Release List and Tag List for quick access to relevant versions.

Gitter channel YouTube LinkedIn Twitter Follow

Related Repositories



Statistical analysis of monthly background checks of gun purchases ...



A graphql API for the gun p2p graph database ...



LevelDB storage plugin for gunDB ...



webcomponent to attach a html lcd to GunDB ...



:radio: WebRTC transport layer for gun ...

Top Contributors

amark PsychoLlama alexlafroscia metasean Stefdv toka forrestjt allenhartwig coolaj86 HelloCodeMing jokesterfr miclill djmrr PenguinMan98 sbeleidy TFarla ayurmedia


package version
aws-sdk >=2.41.0
formidable >=1.1.1
ws ~>2.2.3
dev uws ~>0.14.1
express >=4.15.2
hapi ^16.1.1
inert ^4.2.0
ip ^1.1.5
mocha >=3.2.0
panic-manager ^1.2.0
panic-server ^1.1.0
uglify-js >=2.8.22


-   v0.3.4 zip tar
-   v0.3.3 zip tar
-   v0.3.2 zip tar
-   v0.3.1 zip tar
-   v0.3.0 zip tar
-   v0.2.5 zip tar
-   v0.2.4 zip tar
-   v0.2.3 zip tar
-   v0.2.0-alpha-1 zip tar
-   v0.0.9 zip tar
-   v0.0.9-n zip tar
-   v0.0.9-m zip tar
-   v0.0.9-l zip tar
-   v0.0.9-i zip tar