npm use of @cldwalker's datomic-free wrapper
Last updated 5 years ago by orlin .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install datomic-free -g
SYNC missed versions from official npm registry.


A wrapper around Datomic Free that makes it easy to start Datomic Free transactors and upgrade to newer versions.


For first time users:

With NPM (Node.js)


This npm install datomic-free also auto-installs the bon dependency, globally.

Build Status

If datomic-free doesn't work - set / export $NODE_PATH to the dir containing your global node_modules. Run dirname $(which bon) to find out where they go.

NOTE: please choose either the npm approach above or the manual one below. If you do both, the script may not run as it should. Verify with type -a datomic-free for which there should be only one datomic-free.

If unhappy with this npm distribution just npm rm -g datomic-free.

Manually (zsh)

$ git clone https://github.com/cldwalker/datomic-free.git ~/.datomic-free
$ ~/.datomic-free/bin/datomic-free start

# To make it easy to use `datomic-free` add an alias to your bashrc/zshrc
$ echo 'alias datomic-free=$HOME/.datomic-free/bin/datomic-free' >> ~/.zshrc
$ . ~/.zshrc


The node package versions are independent of datomic-free releases or Datomic itself. Just like with the manual install, the code is cloned to ~/.datomic-free/ and upgrades would be manual too.

Some day there may be a datomic-free upgrade command to git pull as a convenience.

Upgrading Datomic is called datomic-free update, covered in the Usage section below.


$ datomic-free start

To specify transactor.properties, only with an absolute path:

$ datomic-free start /absolute/path/to/transactor.properties

To migrate existing data/ to datomic-free:

$ rm -rf ~/.datomic-free/data
$ cp -R $OLD_DATOMIC_REPO/data  ~/.datomic-free/

Whenever you'd like to update to the latest datomic-free:

$ datomic-free update

This new version is now the active datomic-free version. Since datomic-free keeps data outside of versions in ~/.datomic-free/data, you use the same data across versions by default.

To update to a specific version, pass a version:

$ datomic-free update 0.8.3627

To use another version you've already installed:

$ datomic-free use 0.8.3646


See datomic-free's TODO section about possible improvements. Some of these have already been implemented with dbin which makes it possible to run both datomic-free and datomic-pro servers - using optional JSON configuration.


See LICENSE.txt. This project is in no way affiliated with Datomic (Metadata Partners, LLC).


  • Thanks to @cldwalker for the datomic-free script
  • Thanks to @richhickey and @stuarthalloway for datomic
  • Thanks to @rkneufeld for the downloading function of the shell script
  • Bug fixes: @sherbondy

Current Tags

  • 0.1.3-1                                ...           latest (5 years ago)

7 Versions

  • 0.1.3-1                                ...           5 years ago
  • 0.1.3                                ...           6 years ago
  • 0.1.2                                ...           6 years ago
  • 0.1.1-1                                ...           6 years ago
  • 0.1.1 [deprecated]           ...           6 years ago
  • 0.1.0                                ...           6 years ago
  • 0.0.1                                ...           6 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 1
Dependencies (2)
Dev Dependencies (1)
Dependents (1)

Copyright 2014 - 2016 © taobao.org |