You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Thomas Gazagnaire 418d172464
Merge pull request #1312 from gs0510/remove_target
1 day ago
.github/workflows Add a changelog check 7 months ago
bench/irmin-pack Add comment for list result in layers benchmarks 1 day ago
examples Replace uses of infix Lwt operators with extended let-ops 1 month ago
src irmin-chunk: use pre_hash to compute entry keys 1 week ago
test irmin-pack: Inode detect non roots (#1283) 1 week ago
.gitignore Ignore macos generated files 1 year ago
.ocamlformat fmt: module-item-spacing=compact 2 months ago
.ocamlformat-ignore irmin: update README to 2.0 interface 2 years ago irmin-chunk: use pre_hash to compute entry keys 1 week ago add title 4 years ago
Makefile Print json only for benchmarks and alias dune to remove dune output 1 day ago irmin-mem: include with the Irmin package as irmin.mem 1 month ago ppx_irmin: add an extension point expander 5 months ago
dune-project Bump dune version 4 months ago
irmin-bench.opam More features in bench/tree.exe (#1269) 3 weeks ago
irmin-chunk.opam irmin-mem: include with the Irmin package as irmin.mem 1 month ago
irmin-containers.opam irmin-mem: include with the Irmin package as irmin.mem 1 month ago
irmin-fs.opam Apply fixes to opam files 2 months ago
irmin-git.opam Add constraints to use git.3.3.0 2 weeks ago
irmin-graphql.opam irmin-graphql: enable Logs.Debug in tests 4 weeks ago
irmin-http.opam irmin-mem: include with the Irmin package as irmin.mem 1 month ago
irmin-layers.opam Drop unnecessary post dependencies 2 weeks ago
irmin-mirage-git.opam Add constraints to use git.3.3.0 2 weeks ago
irmin-mirage-graphql.opam Apply fixes to opam files 2 months ago
irmin-mirage.opam irmin-mem: include with the Irmin package as irmin.mem 1 month ago
irmin-pack.opam Prepare 2.3.0 release 2 months ago
irmin-test.opam Apply fixes to opam files 2 months ago
irmin-unix.opam irmin-unix: conflict with x86_32 as well 2 weeks ago
irmin.opam Remove unused dependency 3 weeks ago
ppx_irmin.opam Drop unnecessary post dependencies 2 weeks ago

Irmin - A distributed database built on the same principles as Git

OCaml-CI Build Status Travis-CI Build Status docs

Irmin is an OCaml library for building mergeable, branchable distributed data stores.


  • Built-in snapshotting - backup and restore
  • Storage agnostic - you can use Irmin on top of your own storage layer
  • Custom datatypes - (de)serialization for custom data types, derivable via ppx_irmin
  • Highly portable - runs anywhere from Linux to web browsers and Xen unikernels
  • Git compatibility - irmin-git uses an on-disk format that can be inspected and modified using Git
  • Dynamic behavior - allows the users to define custom merge functions, use in-memory transactions (to keep track of reads as well as writes) and to define event-driven workflows using a notification mechanism


Documentation can be found online at



Please ensure to install the minimum Opam and Ocaml versions which are 2 and 4.07 respectively.

opam list    // listing the installed packages

To install Irmin, the command-line tool and all optional dependencies using opam:

opam install irmin-unix

Note : If you face installation issues due to pinned packages. Run the below commands to unpin and try to install again,

Unpinning irmin-unix package,

opam info irmin-unix // to get available versions
opam pin -s | grep irmin | xargs opam unpin

A minimal installation, containing the reference in-memory backend, can be installed by running:

opam install irmin

The following packages have been made available on opam:

  • irmin - the base package, plus an in-memory storage implementation
  • irmin-chunk - chunked storage
  • irmin-fs - filesystem-based storage using bin_prot
  • irmin-git - Git compatible storage
  • irmin-graphql - GraphQL server
  • irmin-http - a simple REST interface
  • irmin-mirage - mirage compatibility
  • irmin-mirage-git - Git compatible storage for mirage
  • irmin-mirage-graphql - mirage compatible GraphQL server
  • irmin-unix - unix compatibility
  • irmin-pack - compressed, on-disk, posix backend
  • ppx_irmin - PPX deriver for Irmin content types (see
  • irmin-containers - collection of simple, ready-to-use mergeable data structures

For more information about an individual package consult the online documentation.

Development version

To install the development version of Irmin, clone this repository and opam install the packages inside:

git clone
cd irmin/
opam install .


Below is a simple example of setting a key and getting the value out of a Git based, filesystem-backed store.

open Lwt.Infix

(* Irmin store with string contents *)
module Store = Irmin_unix.Git.FS.KV(Irmin.Contents.String)

(* Database configuration *)
let config = Irmin_git.config ~bare:true "/tmp/irmin/test"

(* Commit author *)
let author = "Example <>"

(* Commit information *)
let info fmt = ~author fmt

let main =
  (* Open the repo *)
  Store.Repo.v config >>=

  (* Load the master branch *)
  Store.master >>= fun t ->

  (* Set key "foo/bar" to "testing 123" *)
  Store.set_exn t ~info:(info "Updating foo/bar") ["foo"; "bar"] "testing 123" >>= fun () ->

  (* Get key "foo/bar" and print it to stdout *)
  Store.get t ["foo"; "bar"] >|= fun x ->
  Printf.printf "foo/bar => '%s'\n" x

(* Run the program *)
let () = main

The example is contained in examples/ It can be compiled and executed with dune:

$ dune build examples/readme.exe
$ dune exec examples/readme.exe
foo/bar => 'testing 123'

The examples/ directory also contains more advanced examples, which can be executed in the same way.


The same thing can also be accomplished using irmin, the command-line application installed with irmin-unix, by running:

$ echo "root: ." > irmin.yml
$ irmin init
$ irmin set foo/bar "testing 123"
$ irmin get foo/bar

irmin.yml allows for irmin flags to be set on a per-directory basis. You can also set flags globally using $HOME/.irmin/config.yml. Run irmin help irmin.yml for further details.

Also see irmin --help for list of all commands and either irmin <command> --help or irmin help <command> for more help with a specific command.


Feel free to to report any issues using the Github bugtracker.


See the LICENSE file.


Development of Irmin was supported in part by the EU FP7 User-Centric Networking project, Grant No. 611001.